Эти образцы кода организованы платформой или языком. Каждый языковой каталог содержит README
с дополнительной информацией о том, как запустить образцы для этого конкретного языка. Здесь мы освещаем настройку аутентификации и общий файл конфигурации, используемый всеми образцами.
Для получения дополнительной информации об API, пожалуйста, обратитесь к документации для API контента для покупок и API Центра производителей.
Прежде чем начать работу, проверьте раздел «Начало работы API контента» на документацию по покупкам. Вместо этого вы можете использовать учетные записи служб, чтобы упростить поток аутентификации. Эти образцы также поддерживают использование учетных данных по умолчанию приложения Google.
Настройка аутентификации для API центра производителя аналогична API контента. Просто убедитесь, что выберите API центра производителя в консоли API. Оба API могут быть выбраны, если вы хотите попробовать образцы для обоих API.
Создайте каталог $(HOME)/shopping-samples
для хранения конфигурации.
Если вы не уверены, где это будет расположено в вашей конкретной настройке, запустите образцы (следуя по специфическому языку README
). Ошибки из образцов, связанных либо с этим каталогом, либо с необходимыми файлами, не существующими, обеспечат полный путь к ожидаемому каталогу/файлам.
В этом каталоге также создайте следующие подкаталоги, в зависимости от того, какой API вы хотели бы попробовать:
content
для API контента для покупокmanufacturers
API Центра производителяПоместите файлы, описанные ниже в соответствующем подкаталоге для API, который вы хотите попробовать.
Настройте желаемый метод аутентификации.
Если вы используете учетные данные по приложению Google по умолчанию:
Если вы используете учетную запись службы:
service-account.json
в соответствующих подкатариях конфигурации API.Если вы используете идентификатор клиента OAuth2:
Загрузите свои учетные данные для клиента OAuth2 в файл client-secrets.json
в соответствующих подкаталогах конфигурации API.
Примечание. Образцы предполагают, что вы используете идентификатор клиента OAuth2, который может использовать IP -адрес Loopback для извлечения токенов. Если вы не являетесь или не уверены, что вы, пожалуйста, посетите [OAuth2.0 для мобильных и настольных приложений] (https://developers.google.com/identity/protocols/oauth2installedapp) страница и следите за инструкциями, чтобы создать Новый идентификатор клиента OAuth2 для использования с образцами.
Вы можете настроить несколько методов аутентификации, чтобы попробовать разные потоки, но обратите внимание, что образцы всегда будут использовать первые учетные данные, которые могут быть загружены, в порядке:
Каждый набор образцов использует различный файл конфигурации. Для API контента для покупок возьмите пример merchant-info.json
из корнета репозитория и скопируйте его в $(HOME)/shopping-samples/content
. Далее измените его содержимое соответствующим образом. Он содержит объект JSON со следующими полями:
Поле | Тип | Описание |
---|---|---|
merchantId | число | Торговый центр идентификатор для запуска образцов против. |
accountSampleUser | нить | Если не пустые, адрес электронной почты для пользователя для добавления/удаления в образцах для службы Accounts . |
accountSampleAdWordsCID | число | Если ненулевой, идентификатор клиента AdWords для ссылки/Unlink в образцах для службы Accounts . |
Для API Центра производителя возьмите пример manufacturer-info.json
из корнета репозитория и скопируйте его в $(HOME)/shopping-samples/manufacturers
. Далее измените его содержимое соответствующим образом. Он содержит объект JSON со следующими полями:
Поле | Тип | Описание |
---|---|---|
manufacturerId | число | Идентификатор центра производителя для запуска образцов против. |
websiteUrl | нить | URL (без следы задницы), связанный с учетной записью центра производителя. |
Если вы используете учетные данные клиента OAuth2, после того, как вы получите авторизованный доступ, данные вашего токена будут храниться в файле stored-token.json
в каталоге конфигурации образцов. Если у вас есть какие-либо проблемы, удалите этот файл, и вам будет предложено повторно оформить доступ.
Теперь, когда вы настроили как общий файл конфигурации, так и настраивали учетные данные аутентификации, пришло время создать и запустить любые из приведенных образцов. Как упоминалось ранее, в README
, расположенных в каждом языковом подкаталоге. Веселиться!