login-customer-id
login-customer-id é um cabeçalho de requisição HTTP da API do Google Ads que carrega o ID de cliente da conta de administrador por meio da qual você opera, informando ao Google qual conta da hierarquia está autorizando a chamada em nome da conta de destino.
Toda requisição à API do Google Ads tem como alvo um ID de cliente, a conta cujas campanhas você está lendo ou alterando. Quando essa conta é acessada por meio de uma conta de administrador (MCC), a API também precisa saber o caminho que você percorreu até chegar a ela. Essa é a função do login-customer-id: ele indica a conta de administrador cuja autorização você está exercendo, e é enviado com dez dígitos, sem traços (1234567890, e não 123-456-7890).
A regra geral: se as suas credenciais OAuth pertencem a um usuário que acessa a conta de destino diretamente, geralmente você pode omitir o cabeçalho. Se o acesso vem por uma conta de administrador, o caso normal para agências e para quem usa um token de desenvolvedor emitido para uma MCC, o cabeçalho é obrigatório. Deixá-lo de fora é uma das causas mais comuns de erros USER_PERMISSION_DENIED para desenvolvedores que enxergam a conta perfeitamente na interface web, porque a interface faz a mesma resolução silenciosamente, enquanto a API não.
Há um segundo uso, mais sutil. Em hierarquias profundas, o cabeçalho decide qual contexto de administrador se aplica, e esse contexto afeta o que você pode ver e fazer: orçamentos compartilhados, ações de conversão entre contas e configurações no nível da conta são resolvidos em relação ao administrador por meio do qual você entrou. Enviar a MCC errada em uma estrutura aninhada pode produzir dados parciais em vez de um erro explícito, o que é muito mais difícil de perceber.
Esse é exatamente o tipo de infraestrutura que o Opus Growth elimina. Como executamos o conector como um serviço hospedado, o contexto do administrador é resolvido para você em cada chamada: você se conecta uma vez com o login do Google e nunca precisa lidar com um token de desenvolvedor, um cabeçalho de ID de cliente ou um ciclo de renovação de OAuth.
Perguntas frequentes
Sempre que você acessa uma conta por meio de uma conta de administrador em vez de diretamente, o que abrange praticamente todas as configurações de agência e qualquer integração que use um token de desenvolvedor emitido para uma MCC. Contas de acesso direto geralmente podem omiti-lo.
Mais comumente USER_PERMISSION_DENIED, às vezes CUSTOMER_NOT_ENABLED ou um erro geral de autorização, mesmo que o mesmo usuário consiga abrir a conta normalmente na interface web do Google Ads.
Dez dígitos, sem os traços. Uma conta exibida como 123-456-7890 na interface é enviada como 1234567890 no cabeçalho.