De vorm van dit werk is altijd dezelfde: eerst lezen, dan voorstellen, en iemand ernaar laten kijken voordat er iets gebeurt. Het lezen is het vorige recept; dit is de tweede stap.
Stel het voor
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"
}
}
]
}'
Het antwoordt met een change_id. Google heeft dan elke operatie gecontroleerd, dus een voorstel dat terugkomt is er een dat zou lopen — maar het account is precies zoals het was. De summary is de regel die een mens leest voordat hij beslist, dus schrijf haar voor hem en niet voor een logboek.
Wat er daarna gebeurt
- In een projectkamer verschijnt het voorstel als kaart: wat het zou veranderen, volledig, met Toepassen en Overslaan ernaast.
- Via de API maakt POST /google-ads/v1/changes/{change_id}/apply met {"apply": true} het echt, en false laat het vallen.
- Als het account er een is waar specialisten naar kijken, toont de kamer de kaart zonder de knoppen: ze gaat in plaats daarvan naar hun wachtrij, en zij passen haar toe.
- Noem met task_id de taak van de projectkamer waarop het antwoordt, en het toepassen van de wijziging sluit die taak.
Pauzeren is de wijziging om de voorkeur te geven. Iets verwijderen kan niet terug; pauzeren wel, en de twee leveren meestal hetzelfde op.
Veelgestelde vragen
Wat als één operatie in mijn voorstel fout is?
Het hele voorstel wordt geweigerd, met Googles eigen woorden over welk deel het niet beviel. Er wordt nooit iets gedeeltelijks opgeschreven, dus een wijziging in behandeling is altijd een die volledig zou lopen.
Kan ik meerdere wijzigingen tegelijk voorstellen?
Ja, tot vijftig operaties in één voorstel, en ze worden samen toegepast of helemaal niet. Houd één voorstel toch bij één beslissing: een mens die iets goedkeurt wat hij in één zin kan beschrijven is het punt van de summary.
Hoe lang wacht een voorstel?
Zo lang als nodig. Niets laat het verlopen en niets past het namens jou toe — het blijft in behandeling in het logboek van het account tot een mens het toepast of overslaat.