Сделать вызов 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 » создан.

  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 Explorer.

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

Назад
Настроить клиентскую библиотеку
Далее
Изучите API контента