Начало работы с Merchant API

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

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

Включите Merchant API в вашем проекте Google Cloud.

Если интеграция API используется в AppScript с использованием Shopping Content Service, создаётся проект Google Cloud по умолчанию и автоматически включается сервис Merchant API. Однако перед использованием Merchant API вам всё равно потребуется пройти однократную регистрацию разработчика. Подробнее см. в разделе «Использование сервиса Merchant API в Apps Script» .

Перейти в Google Cloud

Завести аккаунт

Для использования Merchant API вам потребуется учётная запись Merchant Center. Чтобы создать учётную запись Merchant Center, см. раздел «Начало работы с Merchant Center» .

Перейти в Merchant Center

Зарегистрируйтесь как разработчик

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

  1. Свяжите Merchant Center и свой проект Google Cloud: связь одобряется автоматически, поскольку у вызывающего абонента есть действительный токен доступа или ключ API из проекта Google Cloud, и он является авторизованным пользователем учетной записи Merchant Center.

  2. Добавление пользователя-разработчика API в учётную запись Merchant Center: API регистрации добавляет пользователя-разработчика API в учётную запись Merchant Center. Если пользователь уже существует, ему будет предоставлен новый тип доступа. В случае добавления нового пользователя он получит электронное письмо с приглашением от Merchant Center.

Мы рекомендуем вам использовать метод accounts.users.create для добавления дополнительных или резервных разработчиков API, чтобы убедиться, что в случае, если человек покинет вашу организацию или будет удален, у вас все равно останется действующая регистрация разработчика.

После регистрации вы можете просмотреть статус регистрации с помощью GetDeveloperRegistration или отменить регистрацию с помощью UnregisterGCP .

Регистрационный звонок

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  developer_email:"example-email@example.com"
}

После успешного выполнения запроса ожидайте ответ:

{
  "developerRegistration": {
    "name": "accounts/ACCOUNT_ID/developerRegistration",
    "gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
  }
}

После регистрации разработчика API вы можете использовать метод accounts.users.patch , чтобы предоставить ему дополнительные роли, такие как STANDARD и ADMIN .

Получите идентификатор вашего аккаунта

Идентификатор учетной записи можно получить, используя метод accounts.list .

Вы можете использовать Google APIs Explorer для выполнения запросов к API Merchant. APIs Explorer использует Google OAuth 2.0 для аутентификации. Перед выполнением запросов убедитесь, что флажок Google OAuth 2.0 установлен.

Для аутентификации с помощью OAuth 2.0 необходимо войти в свою учётную запись Google, а затем в APIs Explorer. Также необходимо разрешить APIs Explorer управлять вашими товарными листингами и учётными записями.

Следующий запрос показывает, как можно получить идентификатор вашей учетной записи:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

или

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

После успешного выполнения запроса вы увидите следующий ответ:

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

Скопируйте {ACCOUNT_ID} так как он понадобится вам для выполнения других запросов.

Создать основной источник данных о продуктах

Для добавления товара вам необходим основной источник данных о товарах. Следующий запрос показывает, как создать источник данных, который можно использовать для добавления товара в вашу учетную запись:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Замените {ACCOUNT_ID} на идентификатор созданной вами учетной записи Merchant Center.

После успешного выполнения запроса вы увидите следующий ответ:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Скопируйте значение поля name , так как оно понадобится вам для вставки товара.

Через несколько минут созданный источник данных станет доступен для добавления товаров.

Вы можете просмотреть этот источник данных в пользовательском интерфейсе Merchant Center. Подробнее см. в разделе «Как найти вкладку «Источники данных»» .

Вставьте продукт

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

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Замените {DATASOURCE_NAME} значением, скопированным ранее.

После успешного выполнения запроса вы увидите следующий ответ:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

Идентификатор нового товара — online~en~US~tshirt-123 . Вы можете получить информацию об этом товаре с помощью метода accounts.products.get . Вы также можете просмотреть этот товар через пользовательский интерфейс Merchant Center .