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

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

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

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

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

Пример: создание ярлыка

Вы можете использовать метод 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. В следующем примере показано, как применить метку ключевых аккаунтов , созданную в предыдущем примере, к одному из наиболее важных аккаунтов 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 и передать параметр запроса метки в свой запрос, чтобы вернуть только учетные записи с этим ярлыком. В следующем примере показано, как фильтровать учетные записи Merchant Center, связанные с доменом CSS, с использованием id ( 123 ) метки ключевых учетных записей, созданной в примере создания метки . Чтобы получить учетные записи, сделайте запрос GET используя следующий URL-адрес:

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

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

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

Вы также можете использовать метод csses.updatelabels для назначения меток домену CSS, связанному с группой CSS. В следующем примере показано, как применить метку уровня группы ключевых доменов , созданную с помощью метода 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’
}