Управление CSS-метками

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

Для получения дополнительной информации о CSS см. раздел «Сервисы сравнения цен» . Информацию о работе с метками в Центре CSS см. в разделе «Использование меток учетных записей в Центре обслуживания сравнения цен» .

Типы учетных записей CSS

В CSS используются следующие три типа учетных записей:

  • Группы CSS — это учетные записи верхнего уровня, которые могут содержать один или несколько доменов CSS.
  • Домены CSS — это учетные записи самих CSS-файлов, которые размещают товарные объявления от имени продавцов. Каждый домен CSS может принадлежать только к одной группе CSS.
  • Учетные записи Merchant Center — это продавцы, для которых домены CSS размещают товарные объявления. Домены CSS могут быть связаны с несколькими различными типами учетных записей Merchant Center, включая многоклиентские учетные записи (MCA) и индивидуальные учетные записи продавцов. Каждая учетная запись Merchant Center может быть связана только с одним доменом CSS. Для получения дополнительной информации о различных типах учетных записей Merchant Center см. раздел «Типы учетных записей в Центре обслуживания сравнения товаров» .

Типы меток CSS

В CSS используются два типа меток:

  • Метки создаются и присваиваются учетным записям Merchant Center вручную с помощью доменов CSS, а доменам CSS — с помощью групп CSS.
  • Автоматические метки создаются и присваиваются учетным записям Merchant Center автоматически системой CSS Center. Автоматические метки доступны для различных типов показателей учетных записей и могут помочь вам идентифицировать важные учетные записи и значительную активность по ним.

Для получения дополнительной информации о типах меток, включая доступные автоматические метки, см. раздел «Использование меток учетных записей в Центре обслуживания сравнения цен» .

Функциональность Content API и конечные точки для CSS-стилей

API контента предоставляет следующие конечные точки для CSS-стилей:

При обращении к конечным точкам accounts в качестве CSS-домена следует учитывать следующие требования:

  • Для CSS-доменов необходимо указывать их cssId вместо merchantId .
  • Для CSS-доменов необходимо указывать параметр запроса view=CSS .
  • В доменах CSS в accountId необходимо указать идентификатор соответствующей учетной записи Merchant Center.

Пример: Создайте метку

Для создания новой метки можно использовать метод accounts.labels.create . Метки можно применять к CSS-доменам и учетным записям Merchant Center. Однако метки для разных типов учетных записей являются отдельными и не могут использоваться взаимозаменяемо. Чтобы создать метку уровня домена, которую можно применять к учетным записям Merchant Center, связанным с этим доменом, используйте идентификатор CSS-домена в качестве accountId при создании метки. Чтобы создать метку уровня группы, которую можно применять к CSS-доменам, связанным с группой, используйте идентификатор CSS-группы в качестве accountId при создании метки.

В следующем примере показано, как создать метку для ключевых учетных записей на уровне домена , которую затем можно применить к учетным записям Merchant Center, связанным с этим доменом. Для создания метки отправьте POST запрос, используя следующий URL-адрес и тело запроса:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Пример: Применить метку к учетной записи Merchant Center

Вы можете использовать метод accounts.updatelabels для присвоения меток учетной записи Merchant Center, связанной с доменом CSS. В следующем примере показано, как применить метку key-accounts, созданную в предыдущем примере, к одной из ваших наиболее важных учетных записей Merchant Center.

Для применения метки отправьте POST запрос, используя следующий URL-адрес и тело запроса:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

Пример: Используйте метки для фильтрации учетных записей Merchant Center.

После создания и применения меток к учетным записям Merchant Center, связанным с доменом CSS, вы можете использовать метод accounts.list и передать параметр запроса label в вашем запросе, чтобы получить только учетные записи с этой меткой. Следующий пример демонстрирует, как отфильтровать учетные записи Merchant Center, связанные с доменом CSS, используя id ( 123 ) метки key-accounts , созданной в примере «Создание метки» . Чтобы получить учетные записи, выполните GET запрос, используя следующий URL:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

Текст запроса не требуется.

Пример: Применить метку к домену CSS

Вы также можете использовать метод csses.updatelabels для назначения меток домену CSS, связанному с группой CSS. Следующий пример демонстрирует, как применить метку уровня группы key-domains, созданную с помощью метода accounts.labels.create , к одной из ваших наиболее важных учетных записей доменов CSS. Имейте в виду, что метки для доменов CSS и учетных записей Merchant Center являются отдельными. Метки уровня группы должны создаваться с использованием идентификатора группы CSS в качестве accountId .

Для применения метки отправьте POST запрос, используя следующий URL-адрес и тело запроса:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}