Um ID do cliente (customer_id) são os dez dígitos com que o Google dá nome a uma conta de publicidade — escrito 123-456-7890 nas telas do Google Ads, e 1234567890 em qualquer lugar onde uma API o aceite. Toda chamada aqui nomeia um: sobre qual conta você faz o relatório, em qual você propõe uma mudança, a qual pertence o registro de mudanças.
Uma conta é entregue, nunca encontrada
Você não procura uma conta e não pode nomear uma que não lhe entregaram. GET /google-ads/v1/accounts lista aquelas em que a sua organização pode trabalhar, e toda outra chamada recebe um desses valores. Um ID que não está nessa lista é respondido como uma conta que não existe — 404, nunca 403, e com as mesmas palavras nos dois casos, para que ninguém consiga distinguir uma conta real que não pode tocar de um número que não é de ninguém.
Essa lista diz também o que pode acontecer em cada uma. may_change true significa que ali se pode propor uma mudança; false significa que a conta é sua para ler e fazer relatórios, e nada além, que é onde muitas contas ativas começam e ficam.
Dez dígitos com ou sem os hifens, tanto faz. A API normaliza o que você envia e responde na forma com hifens que uma pessoa lê.
Perguntas frequentes
Como faço uma conta entrar nessa lista?
Alguém entrega a você. Ou um parceiro atribui à sua organização uma das contas vinculadas a ele, ou a sua organização nomeia uma conta própria e pede que especialistas cuidem dela — e nos dois casos o convite é aceito, dentro do Google Ads, por quem é dono da conta.
Um agente pode adivinhar um ID?
Ele pode enviar os dez dígitos que quiser e vai ouvir que a conta não existe, que é a mesma resposta que recebe para um número que ninguém jamais usou. Tentar não ensina nada.
Uma conta ou várias?
Quantas tiverem sido entregues a você. Cada chamada nomeia uma, então um assistente que trabalha com várias simplesmente nomeia uma diferente a cada vez.