Начать, начать

API Manufacturer Center (MfC) позволяет приложениям напрямую взаимодействовать с платформой Manufacturer Center . Чтобы помочь вам начать работу, мы предлагаем образцы кода на Java и .NET.

Это руководство поможет вам создать свое первое приложение с помощью API Manufacturer Center. Прежде чем вы сможете начать кодирование, вам нужно сделать несколько вещей.

Поддержка ОТДЫХА

Наш REST API поддерживает основные операции CRUD для двух разных типов ресурсов:

  • Продукт для владельцев брендов и партнеров по обработке данных.
  • И ProductCertification для органов по сертификации.

Остальная часть этой документации будет написана в основном для Product Certification , но процесс должен быть аналогичным для ProductCertification .

Настройте учетную запись в Manufacturer Center

  1. Создайте учетную запись в Производственном центре .

  2. Обязательно запомните, какой адрес электронной почты вы использовали для создания этой учетной записи в Manufacturer Center, так как он понадобится вам позже. На снимках экрана вы увидите, что он представлен как Manufacturer_user@example.com .

Сделайте свой первый запрос API (без строчки кода!)

  1. Перейдите к обозревателю API в нашей документации для разработчиков для Accounts.Products.list .

  2. Убедитесь, что учетная запись Google, вошедшая в систему, указана в параметре «Пользователи» на вкладке «Настройки».

  3. В обозревателе API убедитесь, что в раскрывающемся меню « Аутентификация » выбран Google OAuth 2.0 :

  4. Введите accounts/{account_id} , заменив {account_id} своим идентификатором производителя из учетной записи Manufacturer Center, в поле «родительский» формы и нажмите « Выполнить ».

  5. Вы должны увидеть успешный ответ. Поздравляем! Вы сделали свой первый запрос API Manufacturer Center.

  6. Если у вас еще нет товаров в Производственном центре, их не будет и в списке. На этом этапе вы можете перейти к другим запросам и посмотреть, что они делают. Поскольку это RESTful API, все запросы работают одинаково. Хорошим следующим шагом, когда у вас есть продукты, является использование Accounts.Products.get .

Создайте проект консоли Google API

Запросы к API Manufacturer Center выполняются через ваш проект консоли API. Здесь мы предполагаем, что вы будете получать доступ к своей собственной учетной записи в Manufacturer Center, поэтому мы предлагаем использовать учетные записи служб, чтобы упростить процесс аутентификации. Подробнее о том, как настроить новую учетную запись службы для использования с учетной записью Manufacturer Center, см. в Руководстве по учетным записям служб.

Ваш первый авторизованный запрос API с использованием Java

Теперь, когда вы настроили учетную запись службы и добавили идентификатор учетной записи службы в свою учетную запись в Manufacturer Center, вы можете получить доступ к своей учетной записи, используя доступный код примеров . В этом руководстве используются примеры Java для демонстрации использования API.

  1. Установите Apache Maven , если вы еще этого не сделали.

  2. Загрузите наши примеры покупок с нашей страницы GitHub.

  3. Из подкаталога java создайте образцы Java:

    $ mvn compile

  4. Теперь запустите код ProductsListSample (примером для ProductCertification будет ListProductCertificationsSample ):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Если вы не следовали указаниям по настройке в файле README, прилагаемом к исходным файлам, вы получите сообщение об ошибке, что образец конфигурации не найден. Следуйте инструкциям в README, чтобы создать каталог конфигурации и заполнить его соответствующей информацией. Файл JSON, загруженный вами при настройке учетной записи службы, должен быть помещен в этот каталог с именем файла service-account.json . Не забудьте сообщить коду, где находится ваш файл, установив следующую переменную среды.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Теперь, когда вы настроили конфигурацию примеров, снова запустите код ProductsListSample .

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. На этом Java-программа должна завершить выполнение и распечатать либо список найденных продуктов, либо сообщение о том, что в вашей учетной записи нет продуктов. Если вы получаете сообщение об ошибке, например «Пользователь не может получить доступ к учетной записи 1234567890», это, скорее всего, связано с тем, что вы не настроили пользователя служебной учетной записи в качестве авторизованного пользователя в Manufacturer Center. С точки зрения API, проект API Console отправил запрос от имени пользователя, которого не было в списке авторизованных администраторов Manufacturer Center, поэтому он, конечно же, отклонил этот запрос.

  8. Вы можете экспериментировать с запуском ProductsListSample столько раз, сколько хотите, так как это запрос только для чтения. Вы также можете изучить другие примеры, которые мы создали для Java и .NET.