Ressources
Facturation et recouvrement des paiements
Les dépenses sont prélevées au niveau du compte, pour l’ensemble des campagnes. Un paiement échoué bloque la diffusion avecdelivery_status: "payment_failed" tout en conservant le status actif/en pause configuré de chaque campagne. Corrigez le moyen de paiement du compte, puis appelez Retry Failed Ads Payments une seule fois pour le compte. La réponse met en file d’attente une tentative en arrière-plan ; elle ne confirme pas le paiement. Après le règlement, les campagnes actives peuvent reprendre et les campagnes en pause restent en pause, sous réserve des autres conditions de diffusion.
Consultez Payer les publicités pour le parcours dans le tableau de bord, un exemple de requête, le comportement en cas de requête en double et la gestion des anciennes campagnes.
Configuration initiale
- Scopes :
media:generate,media:read,ad_campaign:create,ad_campaign:update,ad_campaign:basic:read. - Moyen de paiement publicitaire : connecté dans le tableau de bord (solde ou carte). Seul le lancement en a besoin ; les brouillons fonctionnent sans.
1
Générer une création
amount_charged ; solde insuffisant → 402 avec une deposit_url). Interrogez GET /media/{id} jusqu’à ce que status soit ready, puis utilisez file.id :failed rembourse le montant prélevé : ajustez le prompt et réessayez. Vidéo : "type": "video" plus, en option, duration_seconds (5/10/15), resolution (480p–4k) et jusqu’à 4 ID de fichiers reference_media (le premier sert de base à l’image d’ouverture).2
Créer et lancer l'annonce — une seule requête
POST /ads avec un ad_group et un ad_campaign intégrés crée toute l’arborescence en une seule transaction et la lance :"status": "draft" à ad_campaign, puis lancez plus tard avec PATCH /ad_campaigns/{id} {"status": "active"}.Pour réutiliser des conteneurs existants, passez
ad_group_id au lieu de ad_group, ou ad_campaign_id au lieu de ad_campaign.3
Surveiller
Interrogez
GET /ads/{id} : delivery_status correspond à l’état en direct (un bref in_review pour la modération du contenu est normal), et issues[] contient un message lisible pour tout ce que le réseau publicitaire a rejeté de manière asynchrone.Contrôlez la diffusion avec pause / unpause sur les annonces, les groupes d’annonces ou les campagnes. Modifiez le texte ou les créations avec PATCH /ads/{id} : envoyer creatives remplace l’ensemble complet, incluez donc l’entrée de base.Erreurs
Chaque contrôle renvoie une erreur400 dont le message indique ce qu’il faut corriger :

