A forma deste trabalho é sempre a mesma: ler primeiro, propor depois, e deixar que alguém olhe antes que qualquer coisa aconteça. A leitura é a receita anterior; este é o segundo passo.
Proponha
curl -sX POST https://top-rated.team/google-ads/v1/accounts/1234567890/changes \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "Content-Type: application/json" \
-d '{
"summary": "Pause the Brand campaign: CTR under 1% for three weeks",
"operations": [
{
"campaignOperation": {
"update": {
"resourceName": "customers/1234567890/campaigns/987654321",
"status": "PAUSED"
},
"updateMask": "status"
}
}
]
}'
Ela responde um change_id. Até lá o Google já validou cada operação, então uma proposta que volta é uma que rodaria — mas a conta está exatamente como estava. O summary é a linha que uma pessoa lê antes de decidir, então escreva-o para ela e não para um log.
O que acontece depois
- Numa sala de projeto a proposta aparece como um cartão: o que ela mudaria, por inteiro, com Aplicar e Ignorar ao lado.
- Pela API, POST /google-ads/v1/changes/{change_id}/apply com {"apply": true} torna a mudança real, e false a descarta.
- Se a conta é uma de que especialistas cuidam, a sala mostra o cartão sem os botões: ele vai para a fila deles, e eles aplicam.
- Nomeie com task_id a tarefa da sala de projeto a que ela responde, e aplicar a mudança fecha essa tarefa.
Pausar é a mudança a preferir. Remover algo não pode ser desfeito; pausar pode, e os dois costumam render a mesma coisa.
Perguntas frequentes
E se uma operação da minha proposta estiver errada?
A proposta inteira é recusada, com as próprias palavras do Google sobre qual parte ele rejeitou. Nunca se registra nada parcial, então uma mudança pendente é sempre uma que rodaria por completo.
Posso propor várias mudanças de uma vez?
Sim, até cinquenta operações numa proposta, e elas são aplicadas juntas ou não são aplicadas. Mesmo assim, mantenha uma proposta para uma decisão: uma pessoa aprovar algo que consegue descrever numa frase é o sentido do summary.
Quanto tempo uma proposta espera?
O tempo que for preciso. Nada a faz expirar e nada a aplica em seu nome — ela fica pendente no registro da conta até que uma pessoa a aplique ou a ignore.