Обзор Merchant API

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

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

  • Автоматизированное управление счетами
  • Автоматизированное управление продуктами
  • Автоматизированное управление запасами
  • Пользовательская отчетность

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

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

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

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

Для получения дополнительной информации см. Новые функции, представленные в бета-версии Merchant API .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/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/v1beta/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