Настроить клиентскую библиотеку

Встречайте Merchant API (бета) — официального преемника Content API для покупок.

Получайте последние новости о новых функциях, исправлениях ошибок и обновлениях API Merchant (бета-версия).

Узнайте, как управлять своим бизнесом и продуктами в Google и как получить программный доступ к данным, аналитике и уникальным возможностям в масштабе. Начните сейчас

Мы рекомендуем использовать клиентские библиотеки API Google для настройки Content API для покупок. В этом руководстве в качестве примера используются клиентские библиотеки Python Content API, но они доступны для многих популярных языков программирования и упрощают общие задачи API, такие как аутентификация, отправка запросов и анализ ответов. Для получения помощи по настройке клиентских библиотек для других языков см. README.md для языка в репозитории googleads/googleads-shopping-samples на GitHub.

Примечание: Вам необходимо установить несколько требуемых библиотек для использования примера кода в Python. По этой причине мы рекомендуем создать виртуальную среду Python, прежде чем продолжить. Для получения дополнительной информации см. Установка пакетов с помощью pip и виртуальных сред .

Чтобы настроить клиентскую библиотеку Google API для Python, выполните следующие действия:

1. Создайте каталог для файлов конфигурации и аутентификации клиентской библиотеки. В вашем домашнем каталоге создайте следующие каталоги:

   ~/shopping-samples/content/

   Примечание: этот путь, а также имя файла merchant-info.json, созданного на шаге 5, определены в файле python/shopping/content/common.py в каталоге примеров Content API, загруженном на шаге 7.

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

   1. Перейдите в библиотеку API Google .
   2. Выберите проект в меню в верхней части страницы. Если у вас его еще нет, создайте его, нажав Новый проект .
   3. Если вы еще не включили Content API for Shopping для этого проекта, найдите его в списке API Google и включите.
   4. В боковой панели слева выберите Credentials . Возможно, вам придется нажать на стрелку, указывающую влево, в левом верхнем углу, чтобы увидеть это.
   5. Чтобы настроить учетную запись службы, выберите Создать учетные данные , а затем Учетная запись службы .
   6. Назовите новую учетную запись службы. Это также будет именем пользователя по умолчанию для идентификатора учетной записи службы. Запишите идентификатор учетной записи службы, включая часть после символа '@', для дальнейшего использования. Нажмите Создать , затем выполните необязательные шаги по предоставлению доступа проекту и пользователям и нажмите Готово .
   7. Вы будете перенаправлены на страницу учетных записей служб, где сможете получить доступ к своей новой учетной записи служб.

3. Чтобы получить закрытый ключ JSON, щелкните учетную запись службы, затем вкладку Ключи . Щелкните Добавить ключ > Создать новый ключ , а затем выберите JSON в качестве типа ключа. Щелкните Создать , чтобы загрузить закрытый ключ на свой компьютер. Новый ключ загружается автоматически.

4. Переименуйте загруженный файл учетных данных в service-account.json .

   Примечание: это имя файла определено в файле _constants.py , который находится в python/shopping/content/ в каталоге примеров Content API, загруженном на шаге 7.

5. Переместите файл service-account.json в ваш home directory /shopping-samples/content/ .

6. В home directory /shopping-samples/content/ создайте пустой файл merchant-info.json .

7. В merchant-info.json добавьте следующий текст:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Добавьте новую учетную запись службы в качестве пользователя в свою учетную запись Merchant Center. Если вы сторонний разработчик, вам нужно будет, чтобы ваш клиент выполнил этот шаг за вас.

   1. Перейдите в свою учетную запись Merchant Center .
   2. В настройках вашего аккаунта Merchant Center выберите «Люди» и войдите в .

   3. Нажмите «+ Добавить пользователя» и используйте идентификатор учетной записи службы в качестве адреса электронной почты для нового пользователя.

      Примечание: Если вы ранее не записали идентификатор учетной записи службы, перейдите на страницу администрирования учетных записей служб и выберите созданный вами проект.

   4. Для использования службы Accounts требуются права администратора, поэтому выберите «Администратор» .

   5. Нажмите Добавить пользователя , чтобы сохранить настройки и вернуться к списку пользователей. Идентификатор учетной записи службы указан вместе с выбранной ролью пользователя.

   6. Повторите процесс для всех остальных учетных записей служб, которые вы хотите добавить.

9. Клонируйте (или загрузите и распакуйте) репозиторий GitHub googleads/googleads-shopping-samples в любое место на вашем компьютере; он не обязательно должен находиться в вашем домашнем каталоге или в ~/shopping-samples/content/ .

10. Если вы скачали и распаковали репозиторий, вместо его клонирования переименуйте распакованный каталог в googleads-shopping-samples .

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

    pip install -r requirements.txt
    

Теперь у вас есть клиентская библиотека Google API для Python, настроенная и готовая к использованию с Content API. В следующем разделе вы создадите и отправите запрос на вставку нового продукта.