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

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

Для получения дополнительной информации о CSS см. Comparison Shopping Services . Для получения информации о работе с метками в CSS Center см. Use account labels in Comparison Shopping Service Center .

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

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

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

Типы меток CSS

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

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

Дополнительную информацию о типах меток, включая доступные автоматические метки, см. в разделе Использование меток учетных записей в Comparison Shopping Service 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 при создании метки.

Следующий пример демонстрирует, как создать метку key-accounts на уровне домена , которую затем можно применить к учетным записям 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’
}