Tipos de conta na API Google Ads

Este documento explica os diferentes termos usados para descrever contas na API Google Ads e como eles se relacionam.

Visão geral

A API Google Ads usa vários termos para descrever contas, o que às vezes pode gerar confusão. É importante entender essas distinções para gerenciar contas e interpretar respostas da API.

Tipos de conta

As definições a seguir esclarecem os diferentes tipos de conta que você vai encontrar ao trabalhar com a API Google Ads.

Conta de administrador

Uma conta de administrador é uma conta principal usada para gerenciar várias contas do Google Ads.

• Nome anterior:era conhecida como "MCC" (Minha Central de Clientes). Você ainda pode encontrar esse termo em documentações ou discussões legadas.
• Finalidade:normalmente, você precisa de uma conta de administrador para receber um token de desenvolvedor e acessar a API. Ela permite vincular e gerenciar outras contas.

Conta de veiculação

Uma conta de veiculação (ou conta de anunciante) é uma conta individual do Google Ads que veicula campanhas publicitárias.

• Finalidade:é nela que as campanhas, os grupos de anúncios e os anúncios são criados e veiculados.

Conta de clientes

Uma conta de clientes é qualquer conta (de veiculação ou de administrador) vinculada e gerenciada por uma conta de administrador superior na hierarquia.

• Contexto:o termo "cliente" se refere ao relacionamento na hierarquia (gerenciado por um administrador), não necessariamente a um "cliente" no sentido comercial.

Cliente

No contexto da API, um cliente é o recurso que representa qualquer conta do Google Ads, seja de administrador ou de veiculação.

• Representação: todas as contas são representadas por um Customer recurso, identificado por um customer_id.
• Função:a natureza da conta (de administrador ou de veiculação) depende do recurso específico.

Conta de teste

Contas de teste são contas especiais criadas em uma conta de administrador especificamente para testar integrações de API.

• Finalidade:elas permitem testar chamadas de API sem veicular anúncios ativos ou gerar custos. Elas não veiculam anúncios ativos.

Exemplo de hierarquia

Uma hierarquia típica é assim:

• Conta de administrador A (nível superior)
  • Conta de cliente B (conta de veiculação)
  • Conta de cliente C (outra conta de administrador)
    • Conta de cliente D (conta de veiculação)

Neste exemplo:

• A conta A é uma conta de administrador.
• As contas B, C e D são contas de cliente em relação aos pais.
• As contas B e D são contas de veiculação.
• A conta C é uma conta de cliente (para A) e uma conta de administrador (para D).