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

Начало работы с 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 API, необходимо создать связь между вашим проектом Google Cloud и основным аккаунтом Merchant Center. Эта однократная регистрация требуется для каждого проекта Google Cloud, используемого с Merchant API.

Регистрация в качестве разработчика позволяет достичь двух целей:

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

Зарегистрируйте свой проект Google Cloud

Для регистрации вызовите метод developerRegistration.registerGcp . Этот вызов связывает проект Google Cloud, который вы используете для регистрации, с аккаунтом Merchant Center, указанным в запросе.

В тексте запроса необходимо указать адрес электронной почты разработчика, который будет использоваться в качестве технического контакта. Этот адрес должен быть связан с учётной записью Google (Google Workspace или Gmail), например, sampleuser@gmail.com .

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

Вот пример запроса:

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Успешный вызов возвращает ресурс DeveloperRegistration , который подтверждает связь между вашим проектом и вашей учетной записью.

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

Управление контактами и разрешениями разработчиков

После регистрации мы рекомендуем вам добавить нескольких разработчиков и предоставить им дополнительные права доступа.

Предоставить дополнительные разрешения

Роль API_DEVELOPER необходима для получения важных уведомлений, но имеет минимальные разрешения в Merchant Center. Чтобы разрешить этому пользователю выполнять другие вызовы API или управлять настройками в пользовательском интерфейсе Merchant Center, необходимо предоставить ему дополнительные роли, например, STANDARD или ADMIN . Подробнее см. в разделе Типы доступа .

Обновить права доступа пользователя можно с помощью метода accounts.users.patch .

В следующем примере показано, как обновить пользователя, предоставив ему роли ADMIN и API_DEVELOPER . Это позволит ему полностью управлять учётной записью, а также получать сообщения, связанные с API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Добавить резервных разработчиков

Чтобы предотвратить нарушение доступа к API в случае ухода основного разработчика из организации, следует добавить хотя бы одного резервного разработчика.

Вы можете добавить пользователя с помощью метода accounts.users.create или обновить существующего с помощью метода accounts.users.patch . Мы рекомендуем назначить этому пользователю роли ADMIN и API_DEVELOPER .

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

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

POST https://merchantapi.googleapis.com/datasources/v1/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/v1/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} значением, скопированным ранее.