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

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

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

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

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

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

Типы меток CSS

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

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

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

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