Репозиторий googleads/googleads-shopping-samples на GitHub содержит примеры кода для общих операций для каждой клиентской библиотеки. Например, примеры в googleads-shopping-samples/python/shopping/content/products/ предоставляют код для распространенных операций с использованием ресурса products
в Python. В этом руководстве вы начинаете с пустого файла и создаете пример, включающий новый продукт, чтобы вы могли увидеть базовую структуру и необходимые компоненты приложений, которые интегрируются с Content API. Конечный результат будет аналогичен примеру в файле-примере продуктов/insert.py . Затем вы можете использовать API Explorer для метода products.list
, чтобы убедиться, что продукт был успешно добавлен.
Чтобы сделать первый звонок, выполните следующие действия:
В каталоге googleads-shopping-samples/python/shopping/content/products/ создайте пустой файл my-insert.py . Добавьте в этот файл весь код из следующих шагов.
Добавьте операторы импорта для необходимых модулей.
В начале my-insert.py добавьте следующий код:
from __future__ import print_function import sys # The common module provides setup functionality used by the samples, # such as authentication and unique id generation. from shopping.content import common
Определите уникальный идентификатор продукта и создайте словарь с определением продукта.
В конце my-insert.py добавьте следующий код:
offer_id = 'book#%s' % common.get_unique_id() product = { 'offerId': offer_id, 'title': 'A Tale of Two Cities', 'description': 'A classic novel about the French Revolution', 'link': 'http://my-book-shop.com/tale-of-two-cities.html', 'imageLink': 'http://my-book-shop.com/tale-of-two-cities.jpg', 'contentLanguage': 'en', 'targetCountry': 'US', 'channel': 'online', 'availability': 'in stock', 'condition': 'new', 'googleProductCategory': 'Media > Books', 'gtin': '9780007350896', 'price': { 'value': '2.50', 'currency': 'USD' }, 'shipping': [{ 'country': 'US', 'service': 'Standard shipping', 'price': { 'value': '0.99', 'currency': 'USD' } }], 'shippingWeight': { 'value': '200', 'unit': 'grams' } }
Создайте функцию, которая запускается при запуске сценария из командной строки. Функция создает объект службы для взаимодействия с Content API, получает идентификатор продавца из файла конфигурации, создает запрос и выполняет запрос для вызова API.
В конце my-insert.py добавьте следующий код:
def main(argv): # Construct the service object to interact with the Content API. service, config, _ = common.init(argv, __doc__) # Get the merchant ID from merchant-info.json. merchant_id = config['merchantId'] # Create the request with the merchant ID and product object. request = service.products().insert(merchantId=merchant_id, body=product) # Execute the request and print the result. result = request.execute() print('Product with offerId "%s" was created.' % (result['offerId'])) # Allow the function to be called with arguments passed from the command line. if __name__ == '__main__': main(sys.argv)
Чтобы запустить скрипт и выполнить вызов API, в окне терминала перейдите к googleads-shopping-samples/python/ и запустите:
python -m shopping.content.products.my-insert
Если вызов прошел успешно, служба выводит на терминал следующее сообщение: Продукт с идентификатором предложения « offerId » создан.
Чтобы убедиться, что продукт был успешно добавлен, используйте API Explorer для метода
products.list
чтобы вернуть все продукты в вашей учетной записи Merchant Center.В API Explorer для метода
products.list
введите следующие значения:- Введите свой
merchantId
.
- В разделе «Учетные данные» выберите Google OAuth 2.0 и ключ API .
- Нажмите кнопку «Выполнить» .
- При появлении запроса войдите в систему, используя учетную запись Google, связанную с вашей учетной записью Merchant Center.
Если продукт был успешно добавлен, данные о продукте появятся в ответе API Explorer.
- Введите свой
Продавцы несут ответственность за соблюдение правил в отношении товарных объявлений и бесплатных объявлений . Google Shopping оставляет за собой право обеспечивать соблюдение этих правил и реагировать соответствующим образом, если мы обнаружим контент или поведение, нарушающее эти правила.