Facebook Reels API: Bir Sayfaya Reels Yayımlama
Facebook Reels API, bir Reel'i üç adımda bir Sayfaya yayımlar: upload_phase değeri start olan POST /{page-id}/video_reels bir video_id döndürür, video rupload.facebook.com'a gönderilir, ardından upload_phase değeri finish ve video_state değeri PUBLISHED olan POST /{page-id}/video_reels Reel'i yayımlar. Meta'nın belirttiği özellik 9:16 oranında, 3 ila 90 saniyelik bir videodur; bir Sayfa 24 saat içinde API üzerinden 30 Reel yayımlayabilir.
easyCoexistence, Claude, ChatGPT veya kendi kodunuzdan publish_facebook_post ile videoları bir Facebook Sayfasına normal video gönderileri olarak gönderir; metin, bağlantı ve fotoğrafların yanında.
Sayfa başına API ile yayımlanan Reel sayısı, 24 saatlik kayan süre içinde; POST /{page_id}/video_reels üzerinde uygulanır.
Meta'nın kabul ettiği Reel süresi; bir Sayfada hikâye olarak yayımlanan Reel 60 saniyeyi aşamaz.
Minimum Reel çözünürlüğü; Meta 9 x 16 en boy oranında 1080 x 1920 piksel önerir.
Bir Reel için ayarlanabilen en ileri scheduled_publish_time, en az 10 dakika sonrası; video_state değeri SCHEDULED ile.
Facebook'un desteklemediği süreye sahip Reel için hata kodu; Reel'ler 3 ila 90 saniye sürmelidir.
Reels API bir Reel'i nasıl yayımlar?
İki sunucuda üç adımda. Başlatma ve tamamlama çağrıları, Sayfanın video_reels uç noktasına, graph.facebook.com'a gider; video dosyası ise başlatma çağrısının döndürdüğü upload_url üzerinden rupload.facebook.com'a gönderilir. Yükleme ile tamamlama arasında videonun kimliğiyle yapılan bir durum kontrolü, Meta'nın dosyanın tamamını alıp işlediğini gösterir.
Reel için nasıl bir video gerekir?
Meta, Reel özelliklerini Reels Publishing kılavuzunda yayımlar; en boy oranı, çözünürlük, süre veya kare hızı bu özelliklere uymayan bir yükleme, kendine özgü bir hata koduyla reddedilir. Bir Sayfa hikâyesi için düşünülen Reel de 60 saniyeyi aşmamalıdır.
Video nasıl yüklenir?
rupload.facebook.com üzerindeki upload_url'e POST isteğiyle, Authorization: OAuth başlığında Sayfa token'ı taşınarak. Makinenizdeki bir dosya istek gövdesi olarak gönderilir; offset başlığı 0, file_size başlığı ise dosyanın bayt cinsinden boyutuna ayarlanır. Çevrimiçi olan bir dosya ise bunun yerine file_url başlığıyla gönderilir ve Meta dosyayı kendisi çeker; başarılı bir yükleme success değerini true olarak döndürür.
file_urlhttp veya https adreslerini kabul eder; kimlik doğrulama gerektiren URL'ler desteklenmez.- Barındıran sunucu, facebookexternalhit/1.1 kullanıcı aracısının dosyayı çekmesine izin vermelidir; Meta, robots.txt dosyasında bunu engelleyen sitelerdeki dosyaları reddeder.
- Meta'nın kendi CDN'indeki dosyalar, örneğin fbcdn URL'leri, reddedilir; Meta, aynı videoyu başka bir Sayfada yeniden kullanmak için çapraz paylaşıma yönlendirir.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"Bir Reel'in durumu nasıl kontrol edilir?
graph.facebook.com üzerinde GET /{video-id}?fields=status ile. Yanıtta video_status bulunur; değeri uploading, upload_complete, processing, ready, upload_failed, expired veya error olabilir. Ayrıca her aşama için bir nesne vardır: bytes_transfered alanını taşıyan uploading_phase, hata iletisini taşıyan processing_phase ve publish_status (draft, scheduled, published veya error) ile publish_time alanlarını taşıyan publishing_phase. Her aşamanın kendi durumu not_started, in_progress, completed veya error olur.
Kesintiye uğrayan bir yükleme nasıl sürdürülür?
Yükleme POST isteğini, offset başlığında durum kontrolünden gelen uploading_phase.bytes_transfered değeriyle, yani Meta'nın zaten aldığı bayt sayısıyla yeniden göndererek. Meta'nın kabul etmediği bir offset OffsetInvalidError döndürür; dosyanın uzunluğuyla eşleşmeyen bir gövde PartialRequestError döndürür. Yeniden yükleme işe yaramazsa Meta'nın önerisi ilk adımdan yeniden başlamaktır.
Tamamlama çağrısı neleri alır?
Başlatma çağrısından gelen video_id, upload_phase değeri finish ve video_state değeri PUBLISHED, DRAFT veya SCHEDULED. description metni taşır ve hashtag'leri destekler. title, konum Sayfası için place ve Reel'in yapay zekâyla oluşturulduğunu veya düzenlendiğini belirten is_ai_generated isteğe bağlıdır. Zamanlanmış bir Reel, 10 dakikadan sonra ve 29 gün içinde olan bir UNIX zaman damgası olan scheduled_publish_time ekler. Meta, success değerini true olarak yanıtlar.
Bir Sayfa API üzerinden en fazla kaç Reel yayımlayabilir?
24 saatlik kayan bir süre içinde 30. Meta, sınırı bir Reel yayımlandığında POST /{page_id}/video_reels üzerinde uygular; ayrıca uygulamaların bunu kendileri de uygulamasını önerir, özellikle insanların gönderileri sonraya zamanlamasına izin veren uygulamaların. Ortak davetlerinin ise kendi sınırı vardır: Sayfa başına 24 saatte 10. video_reels referansı, 613 kodlu hatayı listeler: bu API'ye yapılan çağrılar istek sınırını aştı.
Hangi izinler ve Sayfa görevi gerekir?
CREATE_CONTENT görevini Sayfada yapabilen birinden alınmış bir Sayfa erişim token'ı; Facebook Login üzerinden verilmiş pages_show_list, pages_read_engagement ve pages_manage_posts izinleriyle. Meta ayrıca uygulamalardan, kişiye Reel'lerinin Facebook'ta nasıl kullanıldığına dair bir bildirim göstermesini ve bunu kontrol etmek için seçenekler sunmasını ister; ayrıca yalnızca Public kitlesini sunmasını ister, çünkü Sayfaya yayımlamanın örtük bir genel kapsamı vardır.
Reels API hangi hataları döndürür?
100 kodu, upload_phase gibi zorunlu bir parametrenin eksik olduğu anlamına gelir; Meta'nın iletisi eksik olanları listeler. Dört kod daha, özelliklerin dışında kalan bir videoyu reddeder:
- 1363040: en boy oranı desteklenmiyor; videoların 16x9 ile 9x16 arasında olması gerekir.
- 1363127: çözünürlük desteklenmiyor; minimum 540 x 960 piksel.
- 1363128: süre desteklenmiyor; Reel'ler 3 ila 90 saniye sürer.
- 1363129: ortalama kare hızı desteklenmiyor; Reel'lerin saniyede 24 ila 60 kare olması gerekir.
Bir Sayfanın Reel'leri nasıl listelenir?
GET /{page-id}/video_reels ile; bu, Sayfanın yayımlanmış Reel'lerini kimlikleri, güncelleme zamanları ve açıklamalarıyla döndürür. since ve until, listeyi today, yesterday, bir UNIX zaman damgası veya yyyy-mm-dd olarak verilen tarihlerle sınırlar; until, since'ten sonra olmalıdır. Meta'nın akış referansı, Sayfada yayımlanan Reel'ler için bu uç noktaya işaret eder.
easyCoexistence üzerinden bir Reel nasıl yayımlanır?
Şu an Reel olarak değil. publish_facebook_post videoları, normal video gönderileri olarak Sayfanın videos uç noktasına gönderir ve easyCoexistence'ın video_reels çağrıları için bir aracı yoktur; Sayfa token'ları verilmediği için üç adım kendi kodunuzdan, onun bağlantısı üzerinden de çalıştırılamaz. Reel'i Facebook'tan veya Meta Business Suite'ten yayımlayın ya da videoyu normal bir video gönderisi olarak paylaşın.
Yaygın hatalar
- Yüklemeyi graph.facebook.com'a göndermek. Video rupload.facebook.com'a, Authorization: OAuth başlığıyla gider; graph.facebook.com yalnızca başlatma, tamamlama ve durum çağrıları için kullanılır.
- Dosyayı Meta'nın çekemeyeceği yerde barındırmak. Giriş arkasındaki, robots.txt dosyası facebookexternalhit/1.1 kullanıcı aracısını engelleyen bir sitedeki ya da fbcdn üzerindeki file_url reddedilir.
- Kesintiye uğrayan bir yüklemede baştan başlamak. Önce durumu okuyun: uploading_phase.bytes_transfered sürdürülecek offset değeridir; yeni bir oturum en son çaredir.
- Bir Sayfa için bir günde 30'dan fazla Reel kuyruğa almak. Meta, API ile yayımlanan Reel'leri 24 saatlik kayan bir süre üzerinden sayar; bu yüzden zamanlanmış olanları aralıklı dağıtın.
Reels API için bir aracı yoktur, bu yüzden bir Reel Facebook'tan veya Meta Business Suite'ten yayımlanır. Bağlantı başına ayda US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşen fiyatla; ilk 3 gün ücretsiz.
Sık sorulan sorular
Bir Reel, API ile bir Facebook profiline ya da gruba yayımlanabilir mi?
Hayır. Meta'nın Reels Publishing API'si Reel'leri yalnızca Facebook Sayfalarına yayımlar ve çapraz paylaşımı yalnızca Sayfalara yapar.
publish_facebook_post Reel yayımlar mı?
Hayır. Metin, bağlantı, fotoğraf ve videoları Sayfaya gönderir. Reel ise video_reels çağrılarını gerektirir; easyCoexistence'ın araçları bu çağrıları yapmaz.
Bir Reel'i telif hakkı eşleşmeleri için nasıl kontrol ederim?
GET /{video-id}?fields=copyright_check_information uç noktasını pages_read_engagement izniyle okuyun. Meta kontrolü yüklemede çalıştırır, birkaç dakika sürebilir ve eşleşmeleri yalnızca sahibi görür.
Reel'imi başka bir Sayfa da yayımlayabilir mi?
Evet, ortak olarak. POST /{video-id}/collaborators isteğinde target_id değeri olarak diğer Sayfanın kimliği verilerek bir davet gönderilir; davet kabul edilirse Reel onların Sayfasında da görünür.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi