Google Ads Apply

Staatus: LIVE — kirjutusõigus kinnitatud

API v20 kinnitatud töötavana (15.03.2026). v18 on lõpetatud (404), v19 ebastabiilne (500). Täielik kirjutustsükkel tõestatud: lisa kampaania negatiiv → GAQL kontroll → eemalda → eemaldamise kontroll. Märksõna peatamised ja reklaamirühma peatamised täielikult karkassitud ja karastatud. CLI-skriptid asukohas scripts/apply-layer/. Suitsutest: scripts/apply-layer/gads-smoke-test.sh <customer_id> Vaata disainidetailide kohta APPLY-LAYER.md ja avaliku CLI teostusjuhendi kohta scripts/apply-layer/README.md. Vaata täieliku operaatori töövookuristiku kohta OPERATOR-PLAYBOOK.md.

Loe esmalt: - OPERATOR-PLAYBOOK.md — täielik operaatori töövoog (ühenda → vali → vaata üle → rakenda → kontrolli → võta tagasi) - APPLY-LAYER.md — disainidokument, API spetsifikatsioonid, vigade käitlemine - drafts/DRAFTS.md — mustandisüsteemi dokumentatsioon

Loe tööruum: - workspace/ads/drafts/_index.md — praegune järjekord - workspace/ads/drafts/_summary.md — prioriseeritud kokkuvõte - workspace/ads/audit-trail/_log.md — eelmised rakendussessioonid (kui on) - workspace/ads/audit-trail/reversal-registry.json — aktiivsed tagasivõtmised

Käsud

Rakenda mustand

/google-ads apply [draft-file]

Voog: 1. Loe mustandifail 2. Parsi kõik pakutud tegevused (eelarvemustandite puhul manifest-esimesena; v1 negatiivide/peatamiste puhul vana parsimine) 3. Valideeri iga tegevus (õige konto, kehtivad sihtmärgid, live rakendusulatuse piires) 4. Lahenda inimloetavad nimed GAQL-i kaudu Google Adsi ressursi ID-deks 5. Kuva kuivkäik koos iga mutatsiooni loetlemisega, tegevustüübi kokkuvõte ja riskihinnang 6. Oota operaatori kinnitust („confirm" või „cancel") 7. Käivita iga tegevus Google Adsi REST API v20 kaudu 8. Kontrolli muudatusi GAQL-i uuestipäringuga 9. Kirjuta auditilugu (sessioonilogi, põhilogi, tagasivõtmisregister) 10. Uuenda mustandi staatus olekusse „applied" 11. Kuva rakendusjärgne kokkuvõte koos tagasivõtmisjuhistega

Vaata mustand üle (ilma rakendamiseta)

/google-ads apply review [draft-file]
/google-ads apply review --all

Voog: 1. Parsi mustand struktureeritud tegevusteks 2. Kuva tegevuste jaotus koos tüübi- ja riskitasemete loendusega 3. Kuva kindlus ja sõltuvused 4. Anna jätka/lükka edasi soovitus 5. Kuva järgmise sammu käsud (kuivkäik või täielik rakendus)

Võrgupäringuid pole, API juurdepääsu pole vaja. Puhas kohalik analüüs.

Kontrolli operaatori staatust

/google-ads apply status

Näitab ühe pilguga: - Ühenduse olek (konto, API versioon, mandaadid) - Ootel mustandid koos staatusega - Aktiivsed tagasivõtmised mustandi kaupa rühmitatud - Hiljutised rakendussessioonid - Soovitatav järgmine samm

Võta üks tegevus tagasi

/google-ads undo [reversal-id]

Voog: 1. Otsi tagasivõtmiskirje failist workspace/ads/audit-trail/reversal-registry.json 2. Kuva, mis tagasi võetakse 3. Hoiata, kui muudatus on olnud live >7 päeva 4. Oota kinnitust 5. Käivita tagasivõtmine Google Adsi API kaudu 6. Kontrolli GAQL-iga 7. Uuenda tagasivõtmisregistrit (staatus: „undone")

Võta kogu mustand tagasi

/google-ads undo-draft [draft-file]

Võtab tagasi KÕIK konkreetse mustandi aktiivsed tegevused. Sama kinnitusvoog.

Vaata rakenduslogi

/google-ads apply log

Näitab hiljutisi rakendussessioone failist workspace/ads/audit-trail/_log.md.

Ulatuse kaitsemeetmed (v1 + v2 eelarved)

Lubatud tegevused

Tegevus	Sihtmärk	Ulatus	Risk
Lisa negatiivne märksõna	Kampaania kriteerium	Kampaaniataseme negatiiv	Madal
Lisa negatiivne märksõna	Reklaamirühma kriteerium	Reklaamirühma taseme negatiiv	Madal
Peata märksõna	Reklaamirühma kriteerium	Sea staatus olekusse PAUSED	Madal
Peata reklaamirühm	Reklaamirühm	Sea staatus olekusse PAUSED	Keskmine
Sea kampaania päevaeelarve	Kampaania eelarve	Uuenda `amount_micros`	Keskmine

Miks need on ohutud

Negatiivsed märksõnad saavad liiklust ainult VÄHENDADA. Nad ei saa suurendada kulu, lõhkuda reklaame ega rikkuda jälgimist.
Märksõnade peatamine peatab liikluse ühele märksõnale. Kogu ajalugu, kvaliteediskoorid ja seadistus jäävad puutumata.
Reklaamirühmade peatamine peatab liikluse märksõnade komplektile. Samad säilitamisgarantiid. Laiem plahvatusraadius kui märksõna peatamine, seega keskmine risk.
Kõik on koheselt tagasivõetavad: eemalda negatiiv või sea staatus tagasi olekusse ENABLED.

Blokeeritud tegevused (kõva tagasilükkamine)

Kui mustand sisaldab tegevusi väljaspool toetatud ulatust, teeb apply-käsk järgmist: 1. Loetleb ulatusevälised tegevused 2. Selgitab, millised on ulatusevälised ja miks 3. Pakub rakendada AINULT ulatusesisesed tegevused 4. Ei käivita kunagi ulatuseväliseid tegevusi olenemata kinnitusest

Tegevus	Versioon	Miks blokeeritud
Pakkumisstrateegia muudatused	v2	Võib häirida Smart Biddingi õppimist
Kampaania loomine	v3	Suur plahvatusraadius
RSA muudatused	v4	Õppeperioodi mõju
Peatatud olemite lubamine	v1-s mitte kunagi	Suurem risk kui peatamine
Millegi kustutamine	Mitte kunagi	Peata selle asemel

Mustandi parsimine

Rakenduskiht parsib mustandi markdown-failidest need sektsioonid:

Sektsioon	Tegevustüüp	Mall
Section A: Negatives to ADD	`ADD_NEGATIVE`	`negative-draft.md`
Section D: CRITICAL KEYWORD-LEVEL RECOMMENDATION	`PAUSE_KEYWORD`	`negative-draft.md`
Section A: Keywords to PAUSE	`PAUSE_KEYWORD`	`pause-draft.md`
Section B: Ad Groups to PAUSE	`PAUSE_ADGROUP`	`pause-draft.md`

Toetatud on nii negative-draft.md kui ka pause-draft.md mallid. Segatüüpi mustandid (negatiivid + peatamised ühes failis) on täielikult toetatud — parser eraldab kõigist kohalduvatest sektsioonidest ja eemaldab duplikaadid.

Eelarvemustandid on erinevad: - Need PEAVAD sisaldama ## Apply Manifest - Manifest on olemasolul määrav - Mustanditaseme meta.budget_policy kontrollib, kas mis tahes netotõus on lubatud

Mustandimallid

drafts/templates/negative-draft.md — negatiivsete märksõnade lisamised + eemaldamised + kitsendused
drafts/templates/pause-draft.md — märksõnade peatamised + reklaamirühmade peatamised + mõjukokkuvõte

Valideerimiskontrollid (enne kuivkäiku)

Enne kuivkäigu kuvamist valideeri:

Konto vaste: Mustandi konto ID vastab ühendatud kontole
Kampaania eksisteerib: Mustandis viidatud kampaania on endiselt olemas (GAQL otsing)
Reklaamirühm eksisteerib: Reklaamirühma ulatusega tegevuste jaoks (GAQL otsing)
Duplikaate pole: Negatiivne märksõna ei eksisteeri juba samas ulatuses
Vastetüüp kehtiv: Ainult PHRASE, EXACT või BROAD
Sihtmärk eksisteerib: Peatatav märksõna on endiselt olemas ja hetkel ENABLED
Reklaamirühma staatus: Reklaamirühma peatamiseks on sihtmärk hetkel ENABLED
Ulatuse piires: Toetatud tegevused on negatiivi lisamine, märksõna peatamine, reklaamirühma peatamine ja manifest-põhised kampaania päevaeelarve muudatused

Kui valideerimine ebaõnnestub, teata, millised tegevused ebaõnnestusid ja miks. Ära blokeeri kogu rakendust — lase kehtivatel tegevustel jätkata.

Kuivkäigu kuva

═══════════════════════════════════════════════════════
 DRY RUN: [draft-file]
═══════════════════════════════════════════════════════

Account: [Name] (CID: [ID])
Actions: [N] valid / [M] total

#    Action           Target                       Detail                      Risk
---  ---------------  ---------------------------  --------------------------  ------
1    ADD NEG          Campaign: [name]             "near me" [PHRASE]          Low
2    ADD NEG          Campaign: [name]             "debris chute" [PHRASE]     Low
...
13   PAUSE KW         AG: [name]                   "waste mgmt" [EXACT]        Low
14   PAUSE AG         Campaign: [name]             [ad group name]             Medium

Summary:
  • 12 negative keyword addition(s)
  • 1 keyword pause(s)
  • 1 ad group pause(s)
  • Reversibility: All actions reversible

⚠️  This will make REAL changes to account [CID].
Type 'confirm' to proceed, or 'cancel' to abort:

Rakendusjärgne kontroll

Pärast käivitamist käivita kontrollpäringud:

Tegevus	Kontrollpäring	Mida kinnitatakse
Lisa kampaania negatiiv	`campaign_criterion` WHERE negative=TRUE	Märksõna eksisteerib kampaanias
Lisa reklaamirühma negatiiv	`ad_group_criterion` WHERE negative=TRUE	Märksõna eksisteerib reklaamirühmas
Peata märksõna	`keyword_view` + staatusekontroll	Staatus on PAUSED
Peata reklaamirühm	`ad_group` + staatusekontroll	Staatus on PAUSED

Auditilugu

Pärast iga rakendussessiooni uuendatakse neid faile:

Põhilogi: workspace/ads/audit-trail/_log.md — ainult juurdelisatav sessioonikokkuvõte
Sessiooni detail: workspace/ads/audit-trail/YYYY-MM-DD-apply-session.md — täielik tegevuse-kaupa logi
Tagasivõtmisregister: workspace/ads/audit-trail/reversal-registry.json — masinloetavad tagasivõtmiskirjed
Mustandifail: Uuendatud rakendamise kuupäeva ja tagasivõtmise ID-dega
Mustandiindeks: workspace/ads/drafts/_index.md — teisaldatud Applied sektsiooni
Muudatuste logi: workspace/ads/change-log.md — kirje sellest, mis muutus

CLI-skriptid

Skript	Eesmärk
`gads-apply.sh`	Täielik rakendusvoog: parsi → valideeri → kuivkäik → kinnita → käivita → kontrolli → audit
`gads-apply.sh --dry-run`	Parsi ja kuva ainult kuivkäik
`gads-apply.sh --parse-only`	Parsi mustand JSON-iks (silumine)
`gads-review.sh`	Parsi ja kuva operaatorile suunatud ülevaatus (API-päringuteta)
`gads-review.sh --all`	Vaata üle kõik ootel mustandid
`gads-undo.sh <rev-id>`	Võta üks tegevus tagasi
`gads-undo.sh --draft <file>`	Võta tagasi kõik mustandi tegevused
`gads-undo.sh --list`	Loetle kõik aktiivsed tagasivõtmised
`gads-status.sh`	Täielik operaatori staatuse ülevaade
`gads-status.sh --applied`	Kuva ainult rakendatud tegevused
`gads-status.sh --pending`	Kuva ainult ootel mustandid
`gads-smoke-test.sh`	Otsast-otsani kirjutustsükli test

Ohutusreeglid

Ära kunagi rakenda ilma kuivkäiguta. Operaator peab nägema täpselt, mis muutub.
Ära kunagi automaatselt kinnita. Operaator peab sõnaselgelt kirjutama „confirm".
Ära kunagi rakenda ulatuseväliseid tegevusi. Kõva tagasilükkamine, selge selgitus.
Ära kunagi kustuta midagi. Peatamine on v1-s maksimaalne raskusaste.
Logi kõike. Iga tegevus, iga viga, iga tagasivõtmine.
Ebaõnnestu graatsiliselt. Kui üks tegevus ebaõnnestub, jätka ülejäänutega. Teata ebaõnnestumisest.
Kontrolli pärast rakendamist. Päri uuesti, et kinnitada muudatuste jõustumist.
Tee tagasivõtmine lihtsaks. Igal tegevusel on salvestatud tagasivõtmisjuhis.
Piira kiirust. Max 50 mutatsiooni rakendussessiooni kohta. 500 ms viivitus mutatsioonide vahel.
Pole partiirakendust üle kontode. Üks konto rakendussessiooni kohta.

Google Adsi muudatuste rakendamine