Reklam Kütüphanesi Reklamı

GET/v1/facebook/adLibrary/adKullanılamıyor

Facebook Reklam Kütüphanesi'nden tek bir reklamı, isteğe bağlı olarak videosunun dökümüyle döndürür. Henüz kullanılamıyor.

Kullanılamıyor

Bu rota, mevcut entegrasyonlar net bir yanıt alsın diye belgelenmiştir ama veri döndürmez: her çağrı ücretsiz bir hatadır ve kredi düşmez. Ne döndürdüğü aşağıdaki notlarda yazılıdır.

01Sorgu parametreleri

Ad	Tür	Açıklama
idisteğe bağlı	string	Reklam Kütüphanesi reklam id'si. `id` ya da `url` parametrelerinden biri zorunludur.
urlisteğe bağlı	string	Bir Reklam Kütüphanesi reklam URL'si, örneğin `https://www.facebook.com/ads/library?id=1702938977100376`. `id` ya da `url` parametrelerinden biri zorunludur.
get_transcriptisteğe bağlı	boolean	Reklamdaki videonun dökümünü eklemek için `true` verin.Varsayılan: `false`
allow_long_transcriptionisteğe bağlı	boolean	120 saniyeden uzun bir videoyu yapay zekâyla yazıya dökmek için `true` verin; başlayan her dakika 10 kredidir. Bu modu yalnızca tam olarak `true` değeri açar.Varsayılan: `false`
trimisteğe bağlı	boolean	Daha kısa bir yanıt için `true` verin.Varsayılan: `false`

02Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/facebook/adLibrary/ad

{
  "success": false,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "error": "missing_parameter",
  "errorStatus": 400,
  "message": "You must provide an 'id' or 'url'"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

03Notlar

Facebook Reklam Kütüphanesi henüz bu API üzerinden kullanılamıyor: zorunlu parametreleriyle yapılan bir çağrı 503 `upstream_unavailable` döndürür ve ücretsizdir. Zorunlu parametreler eksikse yine ücretsiz bir 400 döner.

04Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.