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

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