É possível usar os serviços de comparação de preços (CSSs) para veicular anúncios do Shopping no Google em nome dos comerciantes nos 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 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 contas a seguir:
- Os grupos do CSS são as contas de nível superior que podem conter um ou vários domínios.
- 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 os comerciantes em que domínios do CSS posicionam 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 individuais do comerciante. Cada conta do Merchant Center só pode ser associada a um domínio do CSS. Para mais informações sobre os diferentes tipos de contas do Merchant Center, consulte Tipos de conta no Comparison Shopping Service Center.
Tipos de rótulo CSS
Os CSSs usam dois tipos de rótulos:
- Os rótulos manuais são criados e atribuídos a contas do Merchant Center por domínios do CSS e aos domínios do CSS por grupos do CSS.
- Os rótulos automáticos são criados e atribuídos automaticamente às contas do Merchant Center pelo CSS Center. Os rótulos automáticos estão disponíveis para diferentes tipos de métricas e podem ajudar você a identificar contas importantes e atividades significativas da conta.
Para mais informações sobre os tipos de rótulos, incluindo os rótulos automáticos disponíveis, consulte Usar rótulos da conta no Comparison Shopping Service Center.
Recursos e endpoints da API Content para CSSs
A API Content oferece os seguintes endpoints para CSSs:
accounts.labels
: permite criar, recuperar e modificar rótulos para aplicar a contas do domínio do CSS e do Merchant Center. Para ver um exemplo, consulte Como criar um rótulo.accounts.updatelabels
: permite aplicar rótulos a uma única conta do Merchant Center. Para ver um exemplo, consulte Como aplicar um rótulo a uma conta do Merchant Center.accounts.list
: permite recuperar todas as contas do Merchant Center associadas a um domínio do CSS, incluindo os rótulos aplicados a cada conta. Também é possível filtrar por rótuloid
para recuperar um subconjunto de contas associadas. Confira um exemplo em Como usar rótulos para filtrar contas do Merchant Center.accounts.get
: permite recuperar os rótulos aplicados a uma única conta do Merchant Center.csses
: permite visualizar e gerenciar as associações entre rótulos e domínios do CSS. Por exemplo, consulte Como aplicar um rótulo a um domínio do CSS.
Ao chamar endpoints accounts
como um domínio CSS, esteja ciente dos seguintes requisitos:
- Os domínios do CSS precisam fornecer o
cssId
em vez domerchantId
. - 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 marcador
Use 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 maneira 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 como accountId
ao criar o rótulo.
Confira no exemplo a seguir como criar um rótulo de contas-chave no nível do domínio, que pode ser aplicado às 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
É possível usar o método accounts.updatelabels
para atribuir rótulos a uma conta do Merchant
Center associada a um domínio do CSS. Confira no exemplo a seguir 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 URL e o corpo
da solicitação abaixo:
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, use o método accounts.list
e transmita o parâmetro de consulta do rótulo na 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 key-accounts criado no exemplo Como criar um rótulo. Para recuperar as contas, faça uma solicitação GET
usando o seguinte URL:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
O corpo da solicitação nã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 afiliado a um grupo do CSS. O exemplo a seguir demonstra como aplicar um rótulo no nível do grupo key-domains criado usando o método accounts.labels.create
a uma das suas contas de domínio do CSS mais importantes. Lembre-se de que 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 accountId
.
Para aplicar o rótulo, faça uma solicitação POST
usando o URL e o corpo
da solicitação abaixo:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}