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

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

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

Настройте учетную запись в 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, в поле «родительский» формы и нажмите « Выполнить ».

    Примечание. Если вы ранее не предоставляли разрешение OAuth2, вам будет предложено авторизовать вызов.

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

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

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

Примечание. Если вы хотите совершать звонки от имени клиентов с их собственными учетными записями в Manufacturer Center, см. руководство по авторизации запросов .

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

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

  1. Установите Apache Maven , если вы еще этого не сделали.
  2. Загрузите наши примеры покупок с нашей страницы GitHub.

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

    $ mvn compile
            
  4. Теперь запустите код ProductsListSample :

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            
    .
  5. Если вы не следовали указаниям по настройке в файле README, прилагаемом к исходным файлам, вы получите сообщение об ошибке, что образец конфигурации не найден. Следуйте инструкциям в README, чтобы создать каталог конфигурации и заполнить его соответствующей информацией. Файл JSON, загруженный вами при настройке учетной записи службы, должен быть помещен в этот каталог с именем файла service-account.json .

  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.