Reklam Kütüphanesi Arama

GET/v1/facebook/adLibrary/search/adsKullanılamıyor

Facebook Reklam Kütüphanesi'ndeki reklamlarda anahtar kelimeyle arama yapar, sayfa başına 30 adet. 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
queryzorunlu	string	Reklamlarda aranacak anahtar kelime.
sort_byisteğe bağlı	string	`total_impressions` (en çok gösterim alan önce) ya da `relevancy_monthly_grouped` (en yeni önce).Varsayılan: `total_impressions`Kabul edilen değerler:`total_impressionsrelevancy_monthly_grouped`
search_typeisteğe bağlı	string	`keyword_unordered` kelimeleri herhangi bir sırada eşleştirir, `keyword_exact_phrase` ise yalnızca tam ifadeyi.Kabul edilen değerler:`keyword_unorderedkeyword_exact_phrase`
ad_typeisteğe bağlı	string	Tüm reklamlar ya da yalnızca siyasi ve toplumsal konulu reklamlar.Kabul edilen değerler:`allpolitical_and_issue_ads`
countryisteğe bağlı	string	Tek bir iki harfli ülke kodu ya da `ALL`.Varsayılan: `ALL`
languageisteğe bağlı	string	İki harfli dil kodu, örneğin `EN`.
statusisteğe bağlı	string	Reklam durumu filtresi.Varsayılan: `ACTIVE`Kabul edilen değerler:`ALLACTIVEINACTIVE`
media_typeisteğe bağlı	string	Medya türü filtresi; `MEME` metin içeren bir görsel demektir.Varsayılan: `ALL`Kabul edilen değerler:`ALLIMAGEVIDEOMEMEIMAGE_AND_MEMENONE`
start_dateisteğe bağlı	string	Başlangıç tarihi, `YYYY-MM-DD`.
end_dateisteğe bağlı	string	Bitiş tarihi, `YYYY-MM-DD`.
cursoristeğe bağlı	string	Önceki sayfadaki `cursor` değeri.
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/search/ads

{
  "success": false,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "error": "missing_parameter",
  "errorStatus": 400,
  "message": "You must provide a 'query' parameter"
}

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.