Resources
Facturering en betalingsherstel
Uitgaven worden op accountniveau over alle campagnes geïnd. Een mislukte betaling blokkeert de levering metdelivery_status: "payment_failed", terwijl de geconfigureerde active/paused status van elke campagne behouden blijft. Herstel de betaalmethode van het account en roep vervolgens Retry Failed Ads Payments één keer aan voor het account. Het antwoord plaatst een poging op de achtergrond in de wachtrij; het bevestigt de betaling niet. Na verrekening kunnen actieve campagnes hervatten en blijven gepauzeerde campagnes gepauzeerd, afhankelijk van andere leveringsvereisten.
Zie Betalen voor advertenties voor de flow in het dashboard, een voorbeeldverzoek, het gedrag bij dubbele verzoeken en de afhandeling van legacy-campagnes.
Eenmalige installatie
- Scopes:
media:generate,media:read,ad_campaign:create,ad_campaign:update,ad_campaign:basic:read. - Betaalmethode voor advertenties: gekoppeld in het dashboard (saldo of kaart). Alleen het lanceren vereist deze — concepten werken zonder.
1
Genereer een creative
amount_charged; onvoldoende saldo → 402 met een deposit_url). Poll GET /media/{id} totdat status ready is en gebruik vervolgens file.id:failed betaalt de kosten terug — pas de prompt aan en probeer het opnieuw. Video: "type": "video" plus optioneel duration_seconds (5/10/15), resolution (480p–4k) en maximaal 4 reference_media-bestands-ID’s (de eerste vormt de basis voor het openingsframe).2
Maak de advertentie aan en lanceer deze — één verzoek
POST /ads met een inline ad_group en ad_campaign maakt de hele boomstructuur aan in één transactie en lanceert deze:"status": "draft" toe aan ad_campaign en lanceer later met PATCH /ad_campaigns/{id} {"status": "active"}.Om bestaande containers te hergebruiken, geef je
ad_group_id door in plaats van ad_group, of ad_campaign_id in plaats van ad_campaign.3
Monitoren
Poll
GET /ads/{id}: delivery_status is de live status (een korte in_review voor contentmoderatie is normaal), en issues[] bevat een leesbaar message voor alles wat het advertentienetwerk asynchroon heeft afgewezen.Beheer de levering met pause / unpause op advertenties, advertentiegroepen of campagnes. Bewerk tekst of creatives met PATCH /ads/{id} — het meesturen van creatives vervangt de hele set, dus neem het basisitem op.Fouten
Elke controle is een400 waarvan het bericht aangeeft wat je moet oplossen:

