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 do usuário de comerciantes em países onde o programa CSS está disponível. 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 associados ao domínio. Os grupos do CSS podem rotular e listar os domínios do CSS afiliadas ao grupo. Esses serviços da API Content oferecem conteúdo programático equivalentes a alguns dos recursos disponíveis na página de comparação de Central de serviços.

Para mais informações sobre CSSs, consulte Serviços de comparação de preços. Para mais 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 CSS

Os CSSs usam estes três tipos de conta:

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

Tipos de rótulo CSS

Os CSSs usam dois tipos de rótulo:

  • Rótulos manuais são criados e atribuídos às contas do Merchant Center pelo CSS domínios e para domínios do CSS por grupos do CSS.
  • Rótulos automáticos são criados e atribuídos automaticamente ao Merchant Center pelo CSS Center. Rótulos automáticos estão disponíveis para diferentes tipos métricas de conta importantes e podem ajudar você a identificar contas importantes e atividade da conta.

Para mais informações sobre os tipos de rótulos, incluindo os tipos de rótulos rótulos, 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, considere o seguinte: requisitos:

  • Os domínios do CSS precisam fornecer o cssId em vez do 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 o accountId:
.

Exemplo: criar um marcador

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

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

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 um comerciante. do Merchant Center associada a um domínio do CSS. O exemplo a seguir demonstra como aplicar o rótulo key-accounts 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 seguinte URL e solicite corpo:

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 Com um domínio do CSS, é possível usar o método accounts.list e transmitir o rótulo parâmetro de consulta na sua solicitação para retornar apenas as contas com esse rótulo. A exemplo a seguir demonstra como filtrar as contas do Merchant Center associadas a um domínio do CSS, usando o id (123) das chaves-contas rótulo criado no exemplo Como criar um rótulo. Para recuperar o contas, faça uma solicitação GET usando o seguinte URL:

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

Também é possível usar o método csses.updatelabels para atribuir rótulos a um CSS. domínio afiliado a um grupo do CSS. O exemplo a seguir demonstra como aplique um marcador no nível do grupo key-domains, criado usando o método accounts.labels.create para um dos seus domínios mais importantes do CSS contas de serviço. Lembrete: os rótulos para domínios do CSS e contas do Merchant Center são separados. Os rótulos no nível do grupo precisam ser criados usando um ID do grupo do CSS como o accountId:

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

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

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