Gerenciamento de marcadores do CSS

Os serviços de comparação de preços (CSSs) podem veicular anúncios do Shopping no Google em nome de comerciantes em países onde o programa CSS está disponível. A API Content permite que domínios e grupos do CSS organizem as contas associadas usando rótulos. Os domínios do CSS podem listar, rotular e filtrar as contas do Merchant Center associadas ao domínio. Os grupos do CSS podem rotular e listar os domínios afiliados ao grupo. Esses serviços da API Content oferecem equivalentes programáticos a alguns dos recursos disponíveis no Comparison Shopping Service Center.

Para mais informações sobre os CSSs, consulte Serviços de comparação de preços. Para informações sobre como trabalhar com rótulos no CSS Center, consulte Usar rótulos da conta no Comparison Shopping Service Center.

Tipos de conta do CSS

Os CSSs usam os três tipos de conta a seguir:

  • Os grupos do CSS são as contas de nível mais alto que podem conter um ou vários domínios do CSS.
  • Os domínios do CSS são as contas dos próprios CSSs, que veiculam anúncios do Shopping em nome dos comerciantes. Cada domínio do CSS só pode pertencer a um grupo do CSS.
  • As contas do Merchant Center são dos comerciantes para os quais os domínios do CSS veiculam anúncios do Shopping. Os CSSs podem ser associados a vários tipos diferentes de contas do Merchant Center, incluindo contas de múltiplos clientes (MCAs) e contas de comerciantes individuais. Cada conta do Merchant Center só pode ser associada a um domínio do CSS. Para mais informações sobre diferentes tipos de contas do Merchant Center, consulte Tipos de conta no Comparison Shopping Service Center.

Tipos de rótulo do CSS

Os CSSs usam dois tipos de rótulo:

  • Os rótulos manuais são criados e atribuídos a contas do Merchant Center por domínios do CSS e a domínios do CSS por grupos do CSS.
  • Os rótulos automáticos são criados e atribuídos automaticamente a contas do Merchant Center pelo CSS Center. Os rótulos automáticos estão disponíveis para diferentes tipos de métricas de conta e podem ajudar a identificar contas importantes e atividades significativas.

Para mais informações sobre os tipos de rótulo, incluindo os rótulos automáticos disponíveis, consulte Usar rótulos da conta no Comparison Shopping Service Center.

Funcionalidade e endpoints da API Content para CSSs

A API Content oferece os seguintes endpoints para CSSs:

Ao chamar endpoints accounts como um domínio do CSS, esteja ciente dos seguintes requisitos:

  • Os domínios do CSS precisam fornecer o cssId em vez de um merchantId.
  • Os domínios do CSS precisam fornecer um parâmetro de consulta de view=CSS.
  • Os domínios do CSS precisam fornecer o ID da conta do Merchant Center associada como accountId.

Exemplo: criar um rótulo

Você pode usar o método accounts.labels.create para criar um novo rótulo. Os rótulos podem ser aplicados a domínios do CSS e contas do Merchant Center. No entanto, os rótulos para os diferentes tipos de conta são separados e não podem ser usados de forma intercambiável. Para criar um rótulo no nível do domínio, que pode ser aplicado a contas do Merchant Center associadas ao domínio, use o ID do domínio do CSS como accountId ao criar o rótulo. Para criar um rótulo no nível do grupo, que pode ser aplicado a domínios do CSS afiliados ao grupo, use o ID do grupo do CSS como accountId ao criar o rótulo.

O exemplo a seguir demonstra como criar um rótulo de contas principais no nível do domínio, que pode ser aplicado a contas do Merchant Center associadas ao domínio. Para criar o rótulo, faça uma solicitação POST usando o URL e o corpo da solicitação a seguir:

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

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

Exemplo: aplicar um rótulo a uma conta do Merchant Center

Você pode usar o método accounts.updatelabels para atribuir rótulos a uma conta do Merchant Center associada a um domínio do CSS. O exemplo a seguir demonstra como aplicar o rótulo contas principais criado no exemplo anterior a uma das suas contas mais importantes do Merchant Center.

Para aplicar o rótulo, faça uma solicitação POST usando o URL e o corpo da solicitação a seguir:

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

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

Exemplo: usar rótulos para filtrar contas do Merchant Center

Depois de criar e aplicar rótulos às contas do Merchant Center associadas a um domínio do CSS, você pode usar o método accounts.list e transmitir o parâmetro de consulta de rótulo na sua solicitação para retornar apenas as contas com esse rótulo. O exemplo a seguir demonstra como filtrar as contas do Merchant Center associadas a um domínio do CSS, usando o id (123) do rótulo contas principais criado no exemplo Como criar um rótulo. Para recuperar as contas, faça uma solicitação GET usando o URL a seguir:

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

Nenhum corpo de solicitação é necessário.

Exemplo: aplicar um rótulo a um domínio do CSS

Você também pode usar o método csses.updatelabels para atribuir rótulos a um domínio do CSS afiliado a um grupo do CSS. O exemplo a seguir demonstra como aplicar um rótulo de grupo domínios principais criado usando o método accounts.labels.create a uma das suas contas de domínio do CSS mais importantes. Os rótulos para domínios do CSS e contas do Merchant Center são separados. Os rótulos de grupo precisam ser criados usando um ID de grupo do CSS como accountId.

Para aplicar o rótulo, faça uma solicitação POST usando o URL e o corpo da solicitação a seguir:

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

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