API Manufacturer Center (MfC) позволяет приложениям напрямую взаимодействовать с платформой Manufacturer Center . Чтобы помочь вам начать работу, мы предлагаем образцы кода на Java и .NET.
Это руководство поможет вам создать свое первое приложение с помощью API Manufacturer Center. Прежде чем вы сможете начать кодирование, вам нужно сделать несколько вещей.
Поддержка ОТДЫХА
Наш REST API поддерживает основные операции CRUD для двух разных типов ресурсов:
- Продукт для владельцев брендов и партнеров по обработке данных.
- И ProductCertification для органов по сертификации.
Остальная часть этой документации будет написана в основном для Product Certification , но процесс должен быть аналогичным для ProductCertification .
Настройте учетную запись в Manufacturer Center
Создайте учетную запись в Производственном центре .
Обязательно запомните, какой адрес электронной почты вы использовали для создания этой учетной записи в Manufacturer Center, так как он понадобится вам позже. На снимках экрана вы увидите, что он представлен как Manufacturer_user@example.com .
Сделайте свой первый запрос API (без строчки кода!)
Перейдите к обозревателю API в нашей документации для разработчиков для
Accounts.Products.list
.Убедитесь, что учетная запись Google, вошедшая в систему, указана в параметре «Пользователи» на вкладке «Настройки».
В обозревателе API убедитесь, что в раскрывающемся меню « Аутентификация » выбран Google OAuth 2.0 :
Введите
accounts/{account_id}
, заменив{account_id}
своим идентификатором производителя из учетной записи Manufacturer Center, в поле «родительский» формы и нажмите « Выполнить ».Вы должны увидеть успешный ответ. Поздравляем! Вы сделали свой первый запрос API Manufacturer Center.
Если у вас еще нет товаров в Производственном центре, их не будет и в списке. На этом этапе вы можете перейти к другим запросам и посмотреть, что они делают. Поскольку это RESTful API, все запросы работают одинаково. Хорошим следующим шагом, когда у вас есть продукты, является использование
Accounts.Products.get
.
Создайте проект консоли Google API
Запросы к API Manufacturer Center выполняются через ваш проект консоли API. Здесь мы предполагаем, что вы будете получать доступ к своей собственной учетной записи в Manufacturer Center, поэтому мы предлагаем использовать учетные записи служб, чтобы упростить процесс аутентификации. Подробнее о том, как настроить новую учетную запись службы для использования с учетной записью Manufacturer Center, см. в Руководстве по учетным записям служб.
Ваш первый авторизованный запрос API с использованием Java
Теперь, когда вы настроили учетную запись службы и добавили идентификатор учетной записи службы в свою учетную запись в Manufacturer Center, вы можете получить доступ к своей учетной записи, используя доступный код примеров . В этом руководстве используются примеры Java для демонстрации использования API.
Установите Apache Maven , если вы еще этого не сделали.
Загрузите наши примеры покупок с нашей страницы GitHub.
Из подкаталога
java
создайте образцы Java:$ mvn compile
Теперь запустите код
ProductsListSample
(примером для ProductCertification будетListProductCertificationsSample
):$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
Если вы не следовали указаниям по настройке в файле README, прилагаемом к исходным файлам, вы получите сообщение об ошибке, что образец конфигурации не найден. Следуйте инструкциям в README, чтобы создать каталог конфигурации и заполнить его соответствующей информацией. Файл JSON, загруженный вами при настройке учетной записи службы, должен быть помещен в этот каталог с именем файла
service-account.json
. Не забудьте сообщить коду, где находится ваш файл, установив следующую переменную среды.export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
Теперь, когда вы настроили конфигурацию примеров, снова запустите код
ProductsListSample
.$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
На этом Java-программа должна завершить выполнение и распечатать либо список найденных продуктов, либо сообщение о том, что в вашей учетной записи нет продуктов. Если вы получаете сообщение об ошибке, например «Пользователь не может получить доступ к учетной записи 1234567890», это, скорее всего, связано с тем, что вы не настроили пользователя служебной учетной записи в качестве авторизованного пользователя в Manufacturer Center. С точки зрения API, проект API Console отправил запрос от имени пользователя, которого не было в списке авторизованных администраторов Manufacturer Center, поэтому он, конечно же, отклонил этот запрос.
Вы можете экспериментировать с запуском
ProductsListSample
столько раз, сколько хотите, так как это запрос только для чтения. Вы также можете изучить другие примеры, которые мы создали для Java и .NET.