API üzerinden Facebook Sayfası Hikayeleri
Meta'nın Hikaye API'si, Facebook Sayfasına fotoğraf ve video hikayeleri yayınlar. Fotoğraf hikayesi, published değeri false olarak ayarlanmış şekilde yüklenen bir fotoğraf alır; ardından photo_id ile POST /{page-id}/photo_stories çağrılır. Video hikayesi ise /{page-id}/video_stories üzerindeki başlatma, yükleme ve tamamlama çağrılarından geçer. Video hikayeleri en fazla 60 saniye sürer, fotoğraflar ise 10 MB'a kadardır.
easyCoexistence, Claude, ChatGPT veya kendi kodunuzdan publish_facebook_post ile bir Facebook Sayfasının gönderilerini yayınlar: metin, bağlantı, fotoğraf ve video.
Meta'nın bir Facebook Sayfasında izin verdiği en uzun video hikayesi.
Fotoğraf hikayesi için en büyük dosya boyutu; JPEG, BMP, PNG, GIF veya TIFF biçiminde.
Video hikayesinin en-boy oranı; önerilen 1080 x 1920 piksel, en az 540 x 960 piksel.
GET /{page-id}/stories'nin bildirdiği status değerleri; arşivlenmiş hikayeler yalnızca Sayfanın hikaye arşivi açıkken görünür.
Fotoğraf hikayesi nasıl yayınlanır?
İki çağrıyla. Fotoğrafı, published değeri false olarak ayarlanmış şekilde POST /{page-id}/photos adresine yükleyin; bu, fotoğrafın kimliğini döndürür. Ardından photo_id bu kimliğe ayarlanmış olarak POST /{page-id}/photo_stories gönderin. Meta, success değerini true ve hikaye gönderisinin kimliği olan post_id ile yanıtlar.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}Video hikayesi nasıl yayınlanır?
Üç adımda, bir Reel ile aynı yapıda. upload_phase değeri start olarak ayarlanmış POST /{page-id}/video_stories, rupload.facebook.com üzerinde bir video_id ve bir upload_url döndürür. Video oraya, offset ve file_size başlıklarıyla dosyanın baytları olarak ya da barındırılan dosya için file_url başlığıyla gönderilir. Ardından video_id ve upload_phase değeri finish olarak ayarlanmış POST /{page-id}/video_stories ile video yayınlanır ve post_id döndürülür.
Hangi medya hikayelerde kullanılabilir?
Meta'nın Hikayeler kılavuzu fotoğraf ve video için ayrı spesifikasyonlar verir. Fotoğraflar en fazla 10 MB olan .jpeg, .bmp, .png, .gif veya .tiff dosyalarıdır; PNG dosyalarının 1 MB'ın altında tutulması önerilir. Videolar Reel spesifikasyonunu izler, ancak üst sınırı daha kısadır:
- Dosya: .mp4 önerilir, 9 x 16 en-boy oranında.
- Çözünürlük: önerilen 1080 x 1920 piksel, en az 540 x 960 piksel.
- Kare hızı: saniyede 24 ila 60 kare, sabit, ilerlemeli (progressive) tarama ile.
- Süre: video hikaye için en fazla 60 saniye.
- Kodekler: H.264 veya H.265; VP9 ve AV1 de desteklenir. Ses AAC Low Complexity, 48 kHz, stereo, 128 kbps veya üzeri.
Hangi medya hikaye için kullanılamaz?
Daha önce yayınlanmış bir gönderide kullanılmış fotoğraf veya video. Meta kuralı, hikaye için yüklenen medyanın daha önce bir gönderide kullanılmamış olması gerektiğidir. Barındırılan video da erişilebilir olmalıdır: Meta, robots.txt dosyası facebookexternalhit/1.1 kullanıcı aracısını engelleyen sitelerdeki dosyaları reddeder; ayrıca fbcdn URL'leri gibi kendi CDN'indeki dosyaları da reddeder.
Bir Sayfanın hikayeleri nasıl listelenir?
GET /{page-id}/stories her hikaye için bir nesne döndürür; liste status alanına ya da since ve until ile tarihe göre filtrelenebilir. Her nesne şunları içerir:
post_id: hikaye gönderisinin kimliği.- status: PUBLISHED veya ARCHIVED; arşivlenmiş hikayeler için Sayfanın hikaye arşivinin açık olması gerekir.
creation_time: hikayenin yayınlandığı UNIX zaman damgası.media_typevemedia_id: fotoğraf veya video ve bu medyanın kimliği.- url: hikayenin Facebook adresi, facebook.com/stories/ altında.
Hangi izinler gerekir?
Sayfa üzerinde CREATE_CONTENT görevini yerine getirebilen biri tarafından alınmış bir Sayfa token'ı; Facebook Login veya Facebook Login for Business üzerinden, pages_manage_posts, pages_read_engagement ve pages_show_list izinleriyle. İşletme sistem kullanıcısı olarak yapılan istekler ayrıca business_management gerektirir. Bunlar, Sayfanın akışına yayın yaparken de istenen aynı üç izindir.
Bir hikaye ne zaman yayınlanır?
photo_stories çağrısı ya da video_stories tamamlama çağrısı yapıldığında. Meta'nın Hikaye API'si bir yayın zamanı kabul etmez: photo_stories bir photo_id alır, tamamlama çağrısı ise video_id, upload_phase ve isteğe bağlı is_ai_generated bayrağını alır. Daha sonra yayınlanacak bir hikaye için bu çağrı, o anda kendi zamanlayıcınızdan yapılmalıdır.
easyCoexistence ile hikaye nasıl yayınlanır?
Henüz yapamazsınız. publish_facebook_post hikaye değil, gönderi yayınlar; easyCoexistence'ın photo_stories veya video_stories için aracı yoktur. Sayfa token'ları verilmez, bu nedenle çağrılar kendi kodunuzdan, onun bağlantısı üzerinden de çalıştırılamaz. Hikayeleri Facebook'tan veya Meta Business Suite'ten yayınlayın.
Yaygın hatalar
- Daha önceki bir gönderideki fotoğrafı yeniden kullanmak. Hikaye için medya daha önce yayınlanmış bir gönderiden gelemez; bu yüzden published değeri false olarak yeniden yükleyin.
- 90 saniyelik bir Reel'i hikayeye dönüştürmek. Reel'ler 90 saniyeye kadar olabilir, ancak video hikayesi 60 saniyede durur.
- Listede arşivlenmiş hikayeleri beklemek. Bunlar GET /{page-id}/stories içinde yalnızca Sayfanın hikaye arşivi açıksa görünür.
- Videoyu graph.facebook.com adresine göndermek. Yükleme, rupload.facebook.com üzerindeki upload_url adresine yapılmalıdır; başlatma, tamamlama ve durum çağrıları graph.facebook.com üzerinde kalır.
Hikaye API'si için aracı yoktur, bu yüzden hikayeler Facebook'tan veya Meta Business Suite'ten yayınlanır. Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında, bağlantı eklendikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Bir Reel, Facebook Sayfası hikayesi olarak paylaşılabilir mi?
Evet, 60 saniye veya daha kısaysa. Meta'nın spesifikasyonuna göre Sayfada hikaye olarak yayınlanan bir Reel bu süreyi aşamaz.
Bir video hikayesi yapay zekâ ile üretildi olarak etiketlenebilir mi?
Evet. video_stories tamamlama çağrısında is_ai_generated değerini true yapın; varsayılan değer false'tur.
Bir hikayenin video yüklemesi yarıda kesilirse ne olur?
Yeniden başlatmak için yüklemeyi offset değeri 0 olarak tekrar gönderin; devam ettirmek için ise bir durum kontrolünden gelen bytes_transfered değerini offset olarak ayarlayın.
easyCoexistence bir Facebook Sayfası için ne kadar tutar?
Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında, ilk 3 gün ücretsiz deneme. Her Sayfa bir bağlantıdır ve daha fazla bağlantı eklendikçe bağlantı başına fiyat düşer.
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