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

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

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

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

   ~/покупки-образцы/контент/

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

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

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

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

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

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

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

    pip install -r requirements.txt
    

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