Сделать вызов API

Репозиторий googleads/googleads-shopping-samples на GitHub содержит примеры кода для распространённых операций для каждой клиентской библиотеки. Например, примеры в googleads-shopping-samples/python/shopping/content/products/ содержат код для распространённых операций с использованием ресурса products на Python. В этом руководстве вы начнёте с пустого файла и создадите пример, добавляющий новый товар, чтобы увидеть базовую структуру и необходимые компоненты приложений, интегрируемых с Content API. Конечный результат будет аналогичен примеру в файле-примере products/insert.py . Затем вы можете использовать API Explorer для метода products.list , чтобы убедиться в успешном добавлении товара.

Чтобы совершить первый звонок, выполните следующие действия:

1. В каталоге googleads-shopping-samples/python/shopping/content/products/ создайте пустой файл my-insert.py . Добавьте в него весь код, описанный ниже.

2. Добавьте операторы импорта для требуемых модулей.

   В начале 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
   

3. Определите уникальный идентификатор продукта и создайте словарь с определением продукта.

   В конец 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'
        }
   }
   

4. Создайте функцию, которая будет запускаться при запуске скрипта из командной строки. Функция создаёт объект службы для взаимодействия с 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)
   
   

5. Чтобы запустить скрипт и выполнить вызов API, в окне терминала перейдите в googleads-shopping-samples/python/ и выполните:

   python -m shopping.content.products.my-insert
   

   Если вызов прошел успешно, служба выводит на терминал следующее сообщение: Продукт с offerId « offerId » был создан.

6. Чтобы убедиться, что продукт был успешно добавлен, используйте API Explorer для метода products.list , чтобы вернуть все продукты в вашем аккаунте Merchant Center.

   В API Explorer для метода products.list введите следующие значения:

   1. Введите свой merchantId .
   1. В разделе «Учетные данные» выберите Google OAuth 2.0 и API-ключ .
   2. Нажмите кнопку «Выполнить» .
   3. При появлении соответствующего запроса войдите в систему, используя учетную запись Google, связанную с вашей учетной записью Merchant Center.

   Если продукт был успешно добавлен, данные о продукте появятся в ответе обозревателя API.

Продавцы несут ответственность за соблюдение правил в отношении рекламы и бесплатных объявлений в Google Покупках . Google Покупки оставляет за собой право применять эти правила и принимать соответствующие меры в случае обнаружения контента или поведения, нарушающих эти правила.