API üzerinden Facebook Sayfasına video yayınlama
Bir video, POST /{page-id}/videos isteğiyle Facebook Sayfasına ulaşır. Bunu ya Meta'nın kendisinin indirdiği bir URL olan file_url ile ya da uygulamanın önce Meta'ya yüklediği bir dosyayla yapabilirsiniz. title videonun adını belirler, description ise Meta'nın gönderiyle birlikte gösterebileceği metindir. Ardından Meta dosyayı işler ve GET /{video-id}?fields=status isteği, video_status değerini ready görünene kadar processing olarak bildirir.
easyCoexistence, Claude, ChatGPT veya kendi kodunuzdan publish_facebook_post ile videoları Facebook Sayfalarına hemen ya da 90 güne kadar önceden zamanlayarak gönderir.
Meta, file_url içinde verilen URL'den video dosyasını alamadığında dönen hata kodu.
Çok küçük bir video dosyası için dönen hata kodu; Meta daha büyük bir dosya ister.
videos kenarındaki scheduled_publish_time için aralık; videonun yayımlandığı andan itibaren sayılır.
processing_progress değerinin aralığı; videonun işlemesinin ne kadarının tamamlandığını gösterir ve video_status ile birlikte bildirilir.
Meta'nın Video API genel bakışına göre video yüklemeleri için ana makine; Meta bu ana makineyi, graph-video.facebook.com, kullanımdan kaldırılmış olarak işaretler.
Yüklemenin döndürdüğü dosya tutamacı; videoyu yayımlamak için fbuploader_video_file_chunk olarak /{page-id}/videos'a gönderilir.
Bir video Sayfaya nasıl gönderilir?
Sayfa erişim token'ı ile POST /{page-id}/videos kullanılır. Dosya Meta'ya iki yoldan biriyle ulaşır: Meta'nın kendisinin çektiği erişilebilir bir video URL'si olan file_url veya uygulamanın baytları önce gönderdiği bir yükleme. file_url, parça parça yüklemenin parametresi olan upload_phase ile birlikte kullanılamaz; bu yüzden bir istek iki yoldan yalnızca birini kullanır.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
Çevrimiçi olmayan bir dosya nasıl yüklenir?
Meta'nın video yayımlama rehberi Resumable Upload API'yi kullanır. file_name, file_length ve file_type ile POST /{app-id}/uploads bir oturum açar; file_offset başlığı ve baytlarla POST /upload:{session-id} ise bir tutamaç, h, döndürür. Video, bu tutamaca ayarlanmış fbuploader_video_file_chunk ile, title ve description ile birlikte POST /{page-id}/videos üzerinden yayımlanır. Bu yükleme çağrıları bir kullanıcı erişim token'ı taşır.
- Kesintiye uğrayan bir yükleme, GET /upload:{session-id} isteğinin döndürdüğü
file_offsetdeğerinden devam eder. - Videos referansı aynı kenarda parça parça bir yüklemeyi de belgeler:
upload_phasestart, transfer ve finish,start_offset,file_sizevevideo_file_chunkile.
title ve description ne işe yarar?
title, videonun başlığıdır. description ise Meta'nın sözleriyle, bu video hakkında bir hikâyede gösterilebilecek gönderi metnidir; dolayısıyla gönderinin sözlerinin yazıldığı yer burasıdır. Her ikisi de videos kenarında isteğe bağlıdır; publish_facebook_post mesajını description olarak gönderir ve title'ı ayarlamadan bırakır.
Videonun hazır olduğunu nasıl anlarsınız?
Meta, video geldikten sonra onu işler. GET /{video-id}?fields=status, Meta çalışırken processing, video yüklendiğinde, kodlandığında ve küçük resimleri hazır olduğunda ready, işleme başarısız olursa error değerini döndüren video_status alanını verir; processing_progress ise 0 ile 100 arasında tamamlanan oranı gösterir. Meta ayrıca videos alanındaki Sayfa webhook'ları üzerinden yayımlama durumunu bildirebilir; easyCoexistence bunlara abone olmaz.
Video ne kadar büyük ve uzun olabilir?
Sayfa videos referansı ile Meta'nın video yayımlama rehberi bir azami dosya boyutu veya süre belirtmez; adını verdikleri boyut kuralı, çok küçük bir dosya için hata 382'dir. Meta'nın Reels ve Hikâye rehberleri kendi sürelerini belirler: Reel için 3 ila 90 saniye, video hikâyesi için en fazla 60 saniye. easyCoexistence bir videoyu zamanladığında dosyayı o anda kopyalar ve 1 GB'den büyük olanı kabul etmez.
Hangi izinler ve Sayfa görevi gerekir?
videos referansına ve yayımlama rehberine göre, CREATE_CONTENT görevini yerine getirebilen biri tarafından verilen bir Sayfa token'ı ile pages_manage_posts, pages_read_engagement ve pages_show_list gerekir. Meta'nın Video API genel bakışı bunu daha katı ifade eder: kişi Sayfada yönetici eşdeğeri görevleri yerine getirebilmeli veya Business Manager üzerinden verilen bir Yönetici rolüne sahip olmalıdır.
Video gönderisi hangi hataları döndürebilir?
Meta'nın videos referansı, POST /{page-id}/videos için bunları listeler:
- 389: videoya URL'den erişilemedi.
- 382: video dosyası çok küçük; daha büyük bir dosyayla yeniden deneyin.
- 6000: video dosyası yüklenirken sorun oluştu; başka bir dosyayla yeniden deneyin.
- 6001: video yüklenirken sorun oluştu; yeniden deneyin.
- 368: işlem kötüye kullanım olarak değerlendirildi veya başka şekilde yasaklı.
- 100: geçersiz parametre; 200: izin hatası; 190: geçersiz OAuth 2.0 erişim token'ı.
publish_facebook_post bir videoyu nasıl gönderir?
video_url, dosyaya giden herkese açık bir HTTPS bağlantısını alır; message ile birlikte bunları file_url ve description olarak /{page-id}/videos'a gönderir, böylece Meta videoyu kendisi çeker. Bir gönderi tek bir video içerir ve yanına eklenen bağlantı reddedilir; bu yüzden URL'yi mesaja yazın. Sonuçtaki post_id, Meta'nın döndürdüğü kimliği tutar; videolar için bu, videonun kendi kimliğidir.
Bir video gönderisi nasıl zamanlanır?
publish_facebook_post'a ISO 8601 biçiminde ve saat dilimiyle bir scheduled_at verin; bu zaman 1 dakika ile 90 gün arasında olabilir. easyCoexistence gönderi zamanlandığında videoyu kopyalar ve o saatte Sayfada yayımlar; list_scheduled_posts bunu gösterir, update_scheduled_post zamanını değiştirir veya metnini düzenler, cancel_scheduled_post ise durdurur. Meta'nın videos kenarındaki kendi scheduled_publish_time değeri ise 10 dakika ile 6 ay arasına izin verir.
Yaygın hatalar
- file_url'nin videoyu oynatan bir sayfaya değil dosyanın kendisine işaret etmesi. Meta adresi kendisi indirir; çekemediği bir adres 389 hatasıyla başarısız olur.
- graph-video.facebook.com'a yükleme yapmak. Meta'nın Video API genel bakışı bu ana makineyi video yüklemeleri için kullanımdan kaldırılmış olarak işaretler ve graph.facebook.com kullanılmasını ister.
- Videoyu hazır olmadan duyurmak. video_status ready değerini gösterene kadar durumu kontrol edin; çünkü işleme, yayımlama çağrısı döndükten sonra da sürer.
- Videoyla birlikte bir bağlantı göndermek. publish_facebook_post, dosyanın yanındaki bağlantıyı reddeder; bunun yerine URL'yi mesaja yazın.
Platformunuz aynısını Partner API üzerinde POST /channels/:id/posts ile yapabilir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Bilgisayarımdan bir Facebook Sayfasına API ile video yükleyebilir miyim?
Evet; Meta'nın Resumable Upload API'si ile /{page-id}/videos için bir tutamaç alabilirsiniz veya o kenardaki parça parça yüklemeyi kullanabilirsiniz. publish_facebook_post ise bunun yerine herkese açık bir HTTPS URL'si alır; bu yüzden dosyayı önce barındırın.
Video, Sayfanın akışında görünmeden yüklenebilir mi?
Evet. published değeri false olarak ayarlanırsa gönderi geri tutulur; no_story akış ve zaman çizelgesi hikâyesini bastırır; secret ise video Facebook'ta ve arama sonuçlarında görünmez kalır.
Bir video birden fazla Sayfaya gönderilebilir mi?
Evet, çapraz paylaşım yoluyla: yayımlanmış bir video, kişinin yönettiği diğer Sayfalarda yeniden yüklenmeden paylaşılabilir ve her Sayfada kendi video kimliğini alır.
easyCoexistence bir Facebook Sayfası için ne kadar tutar?
Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; toplam bağlantı sayınıza göre belirlenir ve ilk 3 gün ücretsizdir. Her Sayfa bir bağlantıdı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