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

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

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

Чтобы настроить клиентскую библиотеку API Google для 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. В следующем разделе вы создадите и отправите запрос на добавление нового продукта.