Обзор Merchant API

Вы можете использовать API продавца для

  • Управляйте тем, как ваш бизнес и продукты отображаются в Google.
  • Получите программный доступ к данным, аналитике и уникальным возможностям.
  • Развивайте свой бизнес и привлекайте больше клиентов в Google.

API Merchant может управлять большими и сложными аккаунтами Merchant Center. Типичные примеры использования:

  • Автоматизированное управление счетами
  • Автоматизированное управление продуктами
  • Автоматизированное управление запасами
  • Автоматизированное управление отчетами по эффективности и анализу рынка

API Merchant позволяет создавать и управлять несколькими источниками данных , что позволяет лучше организовать информацию о товарах, акциях и отзывах. С API Merchant вы можете управлять товарами, дополняя другие методы загрузки данных о товарах, такие как файлы и автоподача . API Merchant также позволяет выполнять несколько отдельных запросов параллельно .

API Merchant представляет собой переработанный API Content for Shopping . Он включает в себя несколько подAPI .

Что нового в Merchant API

Вот несколько причин перейти на API торговца:

Прежде чем начать

Для выполнения запроса Merchant API вам необходимо следующее:

  • Учётная запись Merchant Center : это учётная запись, в которую вы будете отправлять запросы, обновлять и загружать данные. Убедитесь, что у вас есть необходимые разрешения для управления товарами и запасами в этой учётной записи.

  • Проект Google Cloud: используйте проект, чтобы получить API-доступ к вашей учетной записи.

  • Ссылка из вашего аккаунта Merchant Center на проект Google Cloud. Создайте ссылку, вызвав метод регистрации разработчика. Вы будете использовать этот аккаунт и этих пользователей для общения по вопросам интеграции API, опросов и возможностей.

  • Подключите свой аккаунт Merchant Center к проекту Google Cloud, зарегистрировавшись как разработчик . Пользователи с ролью разработчика API будут получать сообщения API, включая обязательные объявления об услугах, опросы для разработчиков и информацию о возможностях.

Аутентификация с помощью API торговца

Для аутентификации вы можете использовать следующие варианты:

  • Вы можете сгенерировать идентификатор и секретный ключ клиента OAuth 2.0 для своего приложения. Эти идентификатор и секретный ключ затем можно использовать для генерации учётных данных OAuth 2.0, необходимых для вызовов API к учётной записи Merchant Center.
  • Вы можете создать учетную запись службы и загрузить ее закрытый ключ для совершения вызовов API.

Идентификаторы счетов и продуктов

API продавца использует для идентификации имена ресурсов вместо идентификаторов. Пример имени ресурса для товара: accounts/123456/products/en~US~sku123 , где 123456 — уникальный идентификатор счёта, а en~US~sku123 — уникальный идентификатор товара.

Формат URL запроса

Для работы с ресурсом отправляйте запросы на URL-адреса в следующем формате:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

Часть :{METHOD} опускается для стандартных методов, таких как list и get.

Например, следующий запрос удаляет региональный инвентарь:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Чтобы создать ресурс, используйте имя родительского ресурса и этот URL:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Например, следующий запрос показывает, как можно создать регион для accounts/123456 :

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Более подробную информацию о конкретных услугах см. в справочной документации Merchant API .

Начните использовать API торговца

Чтобы быстро увидеть, как работает API Merchant, и попробовать загрузить образец продукта, ознакомьтесь со статьей Начало работы с API Merchant .

Используйте gRPC или REST

API Merchant поддерживает gRPC и REST . Вот два способа выполнения вызовов API Merchant:

gRPC (рекомендуется) ОТДЫХ
  1. Создайте тело запроса как буфер протокола.
  2. Отправьте тело запроса на сервер по протоколу HTTP/2.
  3. Десериализуйте ответ в буфер протокола.
  4. Интерпретируйте результаты.
  1. Создайте тело запроса как JSON-объект.
  2. Отправьте его на сервер, используя HTTP 1.1.
  3. Десериализуйте ответ как объект JSON.
  4. Интерпретируйте результаты.

Используйте клиентские библиотеки и примеры кода

Для каждого под-API предусмотрены клиентские библиотеки , которые помогут вам начать работу. Примеры кода помогут вам начать писать код на Java, PHP и Python. Подробнее см. в разделе «Примеры для API Merchant» .

Получить помощь

Информацию о получении поддержки см. в разделе Получение помощи по API торговца .

Оставьте отзыв

Чтобы оставить отзыв, отправьте один из следующих вариантов:

  • Функции API: Выберите опцию «Отправить отзыв» в разделе «В чем проблема/вопрос? » формы обратной связи .
  • Документация: используйте встроенные оценки и кнопку «Отправить отзыв» .
  • Примеры и библиотеки: Создайте задачу в репозитории GitHub для получения примеров кода.

Что дальше?

Назад
Latest updates
Далее
Design