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

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

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

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

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

Перейти в Google Cloud

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

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

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

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

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

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

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

Примечание. Пользователи API Developer — это обычные пользователи Merchant Center с ролью API_DEVELOPER . Их также можно добавлять, обновлять или удалять с помощью пользовательского интерфейса Merchant Center или методов API accounts.users .

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

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

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

{
  developer_email:"[e-mail]"
}

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

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

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

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

Вы можете использовать Google API 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

или

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 для просмотра этого продукта .