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

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

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

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

   ~/shopping-samples/content/

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

   1. Перейдите в библиотеку API Google .
   2. Выберите проект в меню в верхней части страницы. Если у вас ещё нет проекта, создайте его, нажав «Новый проект» .
   3. Если вы еще не включили Content API для покупок для этого проекта, найдите его в списке 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. В следующем разделе вы создадите и отправите запрос на добавление нового товара.