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

Мы хотели бы представить бета-версию Merchant API . Это новая версия Content API для покупок и будущего.

Информацию о том, как Merchant API может улучшить вашу интеграцию и как вы можете помочь сформировать будущее, см. в разделе «Анонс бета-версии Merchant API» .

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

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

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

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

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

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

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

   1. В Merchant Center в меню «Настройки» выберите Content API .
   2. Нажмите Аутентификация .
   3. Нажмите [+] СОЗДАТЬ КЛЮЧ API .
   4. При появлении запроса прочитайте и примите условия соглашения об обслуживании.

   Новый ключ загружается автоматически.

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

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

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

5. В своем home directory /shopping-samples/content/ создайте пустой файл Merchant-info.json .

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

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

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

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

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

   pip install -r requirements.txt
   

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