Начните работу со службами сравнения цен (CSS)

Выполнение базовых операций с API — хороший способ начать его использовать.

Предпосылки

Прежде чем начать, выполните следующее:

  • Убедитесь, что у вас есть действующая учетная запись CSS Center.
  • Зарегистрируйте разработчика API.
  • Проверьте правильность настройки ваших разрешений.
  • Убедитесь, что вы включили CSS API.
  • Убедитесь, что вы установили клиентские библиотеки для своей среды.

Более подробную информацию см. в разделе Быстрый старт .

Включить CSS API

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

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

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

Добавьте пользователя-разработчика API в учётную запись CSS Center: если пользователь уже существует, ему будет предоставлен новый тип доступа «Разработчик API». Новый пользователь получит электронное письмо с приглашением от CSS Center.

После регистрации вы можете просмотреть статус регистрации с помощью GetDeveloperRegistration или отменить регистрацию с помощью UnregisterGCP . Для этого можно использовать следующий регистрационный вызов:

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

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

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

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

CSS-продукты

Подобно API-интерфейсу Products , CSS API различает CssProductInput и ListCssProduct . Для вставки товара используйте InsertCssProductInput .

Как только наши внутренние системы обработают продукт (это может занять несколько минут), извлеките его с помощью ListCssProducts .

Идентифицируйте свои продукты с помощью raw_provided_id . Мы рекомендуем использовать идентификатор, который вы уже используете в своей системе. В качестве альтернативы, для его создания можно использовать один из следующих способов:

  • Глобальные уникальные идентификаторы (GUID)
  • Универсальные уникальные идентификаторы (UUID)
  • Объединенные уникальные атрибуты продукта (например, brand_model_color_size)

Для получения дополнительной информации см. раздел Вставка/Список/Обновление/Удаление продукта .

Основные операции

Вот несколько основных запросов, которые вы можете попробовать.

  1. Вставьте тестовый продукт с помощью InsertCssProductInput . Чтобы узнать, какие атрибуты нужно отправлять, ознакомьтесь с этим примером кода .

  2. Перечислите все свои товары с помощью ListCssProducts . Обратите внимание, что между добавлением товара и его появлением в списке есть небольшая задержка. Если вы не видите товар сразу, повторите попытку через несколько секунд.

  3. Обновите один товар с помощью UpdateCssProductInput , используя ваш cssproductinput.name . Вам нужно отправить только те атрибуты, которые необходимо обновить. Пример см. в примере кода .

  4. Удалите тестовый продукт с помощью DeleteCssProductInpu , указав raw_provided_id .

Ограничения

Добавление или удаление отдельного товара может быть медленным. Для повышения производительности используйте асинхронный режим . Это позволяет вызывать API параллельно.

Перечислите и пометьте свои счета

Управление метками в CSS API позволяет программно организовывать клиентские аккаунты Merchant Center с помощью пользовательских тегов. Эта функция помогает эффективно классифицировать клиентов (например, по типу или стратегии), обеспечивая лучшую организацию и оптимизацию операций. С помощью API можно выполнять следующие функции с метками: