Ressourcer
Fakturering og genopretning af betalinger
Forbrug opkræves på kontoniveau på tværs af kampagner. En mislykket betaling blokerer levering meddelivery_status: "payment_failed", mens hver kampagnes konfigurerede active/paused-status bevares. Ret kontoens betalingsmetode, og kald derefter Retry Failed Ads Payments én gang for kontoen. Svaret sætter et forsøg i kø i baggrunden; det bekræfter ikke betalingen. Efter afregning kan aktive kampagner genoptages, og pausede kampagner forbliver pausede, med forbehold for andre leveringskrav.
Se Betaling for annoncer for dashboard-forløbet, et anmodningseksempel, adfærd ved duplikerede anmodninger og håndtering af ældre kampagner.
Engangsopsætning
- Scopes:
media:generate,media:read,ad_campaign:create,ad_campaign:update,ad_campaign:basic:read. - Betalingsmetode til annoncer: tilknyttes i dashboardet (saldo eller kort). Kun lancering kræver den — kladder virker uden.
1
Generér en kreativ
amount_charged; utilstrækkelig saldo → 402 med en deposit_url). Poll GET /media/{id}, indtil status er ready, og brug derefter file.id:failed refunderer beløbet — justér prompten, og prøv igen. Video: "type": "video" plus valgfri duration_seconds (5/10/15), resolution (480p–4k) og op til 4 reference_media-fil-ID’er (den første danner grundlag for åbningsbilledet).2
Opret og lancér annoncen — én anmodning
POST /ads med en inline ad_group og ad_campaign opretter hele træet i én transaktion og lancerer det:"status": "draft" til ad_campaign, og lancér senere med PATCH /ad_campaigns/{id} {"status": "active"}.For at genbruge eksisterende containere skal du sende
ad_group_id i stedet for ad_group eller ad_campaign_id i stedet for ad_campaign.3
Overvåg
Poll
GET /ads/{id}: delivery_status er den aktuelle tilstand (en kort in_review til indholdsmoderering er normal), og issues[] indeholder en menneskeligt læsbar message for alt, hvad annoncenetværket har afvist asynkront.Styr levering med pause / unpause på annoncer, annoncegrupper eller kampagner. Redigér tekst eller kreativer med PATCH /ads/{id} — når du sender creatives, erstattes hele sættet, så husk at inkludere basisposten.Fejl
Hver kontrol er en400, hvis besked fortæller, hvad der skal rettes:

