Relacje strony Facebook przez API
Stories API Meta publikuje zdjęcia i wideo jako relacje na stronie Facebook. Relacja ze zdjęciem wymaga zdjęcia przesłanego z published ustawionym na false, a następnie POST /{page-id}/photo_stories z jego photo_id. Relację wideo tworzą wywołania start, upload i finish na /{page-id}/video_stories. Relacje wideo trwają do 60 sekund, a zdjęcia mogą mieć do 10 MB.
easyCoexistence publikuje posty strony na Facebooku za pomocą publish_facebook_post z Claude, ChatGPT lub własnego kodu: tekst, linki, zdjęcia i wideo.
Najdłuższa relacja wideo, jaką Meta dopuszcza na stronie Facebook.
Największy rozmiar pliku zdjęcia do relacji, w formatach JPEG, BMP, PNG, GIF lub TIFF.
Proporcje relacji wideo, z zalecaną rozdzielczością 1080 x 1920 pikseli i minimum 540 x 960.
Statusy, które raportuje GET /{page-id}/stories; zarchiwizowane relacje pojawiają się tylko przy włączonym archiwum relacji strony.
Jak opublikować relację ze zdjęciem?
W dwóch wywołaniach. Prześlij zdjęcie do POST /{page-id}/photos z published ustawionym na false, co zwraca ID zdjęcia, a następnie wyślij POST /{page-id}/photo_stories z photo_id ustawionym na to ID. Meta odpowiada success ustawionym na true oraz post_id, czyli ID posta z relacją.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}Jak opublikować relację wideo?
W trzech krokach, w tym samym schemacie co Reel. POST /{page-id}/video_stories z upload_phase ustawionym na start zwraca video_id i upload_url na rupload.facebook.com. Wideo wysyłasz tam jako bajty pliku z nagłówkami offset i file_size albo jako nagłówek file_url dla pliku hostowanego. Następnie POST /{page-id}/video_stories z video_id i upload_phase ustawionym na finish publikuje relację i zwraca post_id.
Jakich mediów może używać relacja?
Wytyczne Stories od Meta podają specyfikację dla zdjęć i dla wideo. Zdjęcia to pliki .jpeg, .bmp, .png, .gif lub .tiff o rozmiarze do 10 MB, przy czym PNG najlepiej trzymać poniżej 1 MB. Wideo podlega specyfikacji Reels, z krótszym limitem:
- Plik: zalecany .mp4 w proporcji 9 x 16.
- Rozdzielczość: zalecane 1080 x 1920 pikseli, minimum 540 x 960.
- Liczba klatek: od 24 do 60 klatek na sekundę, stała, z skanowaniem progresywnym.
- Długość: maksymalnie 60 sekund dla relacji wideo.
- Kodeki: H.264 lub H.265, z obsługą VP9 i AV1; audio w AAC Low Complexity, 48 kHz, stereo, 128 kbps lub więcej.
Jakich mediów nie można użyć w relacji?
Zdjęcia lub wideo użyte już w opublikowanym wcześniej poście: zasada Meta mówi, że media przesłane do relacji nie mogą pochodzić z takiego posta. Hostowane wideo musi być też osiągalne, bo Meta odrzuca pliki na stronach, których robots.txt blokuje agenta użytkownika facebookexternalhit/1.1, oraz pliki z własnej sieci CDN, na przykład adresy fbcdn.
Jak wyświetlić listę relacji strony?
GET /{page-id}/stories zwraca jeden obiekt na relację, a listę można filtrować według statusu lub daty za pomocą since i until. Każdy obiekt zawiera:
post_id: ID posta z relacją.- status: PUBLISHED lub ARCHIVED; zarchiwizowane relacje wymagają włączonego archiwum relacji strony.
creation_time: znacznik czasu UNIX z chwili opublikowania relacji.media_typeimedia_id: photo lub video oraz ID tego medium.- url: adres relacji na Facebooku, pod facebook.com/stories/.
Jakich uprawnień to wymaga?
Potrzebny jest token Strony, wystawiony przez osobę, która może wykonać zadanie CREATE_CONTENT na stronie, przez Facebook Login lub Facebook Login for Business, z przyznanymi uprawnieniami pages_manage_posts, pages_read_engagement i pages_show_list. Żądania wykonywane jako użytkownik systemowy firmy wymagają też business_management. To te same trzy uprawnienia, o które prosi publikowanie na tablicy strony.
Kiedy relacja zostaje opublikowana?
W chwili wykonania wywołania photo_stories albo finish na video_stories. Stories API Meta nie przyjmuje czasu publikacji: photo_stories przyjmuje photo_id, a wywołanie finish przyjmuje video_id, upload_phase i opcjonalną flagę is_ai_generated. Relację na później trzeba wywołać w odpowiednim momencie, z własnego harmonogramu.
Jak opublikować relację przez easyCoexistence?
Jeszcze nie. publish_facebook_post publikuje posty, a nie relacje, a easyCoexistence nie ma narzędzia do photo_stories ani video_stories; tokeny Strony nie są udostępniane, więc wywołania nie mogą też działać z Twojego własnego kodu na jego połączeniu. Publikuj relacje z Facebooka lub Meta Business Suite.
Typowe błędy
- Ponowne użycie zdjęcia z wcześniejszego posta. Media do relacji nie mogą pochodzić z już opublikowanego posta, więc prześlij je ponownie z published ustawionym na false.
- Zamiana Reel o długości 90 sekund w relację. Reels mogą trwać do 90 sekund, ale relacja wideo kończy się na 60.
- Oczekiwanie zarchiwizowanych relacji na liście. Pojawiają się one w GET /{page-id}/stories tylko przy włączonym archiwum relacji strony.
- Wysyłanie wideo na graph.facebook.com. Przesłanie musi trafić pod upload_url na rupload.facebook.com, a wywołania start, finish i status zostają na graph.facebook.com.
Nie ma narzędzia do Stories API, więc relacje publikuje się z Facebooka lub Meta Business Suite. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, cena spada wraz z kolejnymi połączeniami, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy Reel można udostępnić jako relację na stronie Facebook?
Tak, jeśli trwa 60 sekund lub krócej: specyfikacja Meta mówi, że Reel opublikowany jako relacja na stronie nie może przekraczać tego limitu.
Czy relację wideo można oznaczyć jako wygenerowaną przez AI?
Tak. Ustaw is_ai_generated na true w wywołaniu finish na video_stories; domyślnie ma wartość false.
Co zrobić, gdy przesyłanie wideo do relacji zostanie przerwane?
Wyślij przesyłanie ponownie z offset ustawionym na 0, aby zacząć od nowa, albo z offset ustawionym na wartość bytes_transfered z kontroli statusu, aby wznowić.
Ile kosztuje easyCoexistence dla strony na Facebooku?
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, z pierwszymi 3 dniami bezpłatnie. Każda strona to jedno połączenie, a cena za połączenie spada wraz z dodawaniem kolejnych.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w