Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

Перейти в Google Cloud

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

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

Перейти в Мерчант Центр

Получите идентификатор своей учетной записи

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

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

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

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

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

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

{
  "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 .

Статус запуска

Обзор