Reklam Kütüphanesi Şirket Reklamları (POST)

POST/v1/facebook/adLibrary/company/adsKullanılamıyor

GET /v1/facebook/adLibrary/company/ads endpoint'inin JSON gövdeli biçimi: aynı parametreler bir JSON nesnesi olarak gönderilir. 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
pageIdisteğe bağlı	string	Reklamverenin sayısal Facebook sayfa id'si (Reklam Kütüphanesi şirket aramasından). `pageId` ya da `companyName` parametrelerinden biri zorunludur.
companyNameisteğe bağlı	string	Şirketin adı. `pageId` ya da `companyName` parametrelerinden biri zorunludur.
countryisteğe bağlı	string	Tek bir iki harfli ülke kodu ya da `ALL`.Varsayılan: `ALL`
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`
languageisteğe bağlı	string	İki harfli dil kodu, örneğin `EN`.
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`
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.

POST /v1/facebook/adLibrary/company/ads{}

{
  "success": false,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "error": "missing_parameter",
  "errorStatus": 400,
  "message": "You must provide a 'pageId' or 'companyName' 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.