TL;DR, szybka odpowiedź
8 min czytaniascheduled_publish_time to parametr Graph API, dzięki któremu nieopublikowany post, zdjęcie lub film na stronie na Facebooku ukazuje się później. W postach, zdjęciach i filmach działa tylko razem z published=false. Przewodnik Pages API od Meta przyjmuje znacznik czasu UNIX w sekundach, ciąg ISO 8601 lub dowolny ciąg strtotime(). Wszystkie strony Meta zgadzają się co do minimum 10 minut, ale maksimum wynosi 30 dni w przewodniku Pages API, 75 dni w dokumentacji Page Feed, 6 miesięcy w dokumentacji Page Videos i 29 dni w przewodniku publikowania Reels, gdzie pole przyjmuje tylko znacznik czasu Unix i łączy się z video_state=SCHEDULED. Meta nie publikuje konkretnego komunikatu błędu dla czasu spoza zakresu, a jedynie kod 100, Invalid parameter.
Czym jest scheduled_publish_time na Facebooku?
Pole scheduled_publish_time to parametr Graph API, który mówi Meta, kiedy nieopublikowany post na stronie ma się ukazać. Wysyłasz je w tym samym żądaniu POST, które tworzy post. Występuje w /{page-id}/feed dla postów tekstowych i z linkami, w /{page-id}/videos dla wideo oraz w /{page-id}/photos dla zdjęć.
Przewodnik po postach w Pages API wymienia je jako podpunkt published i to pierwsza rzecz, którą trzeba o nim wiedzieć: "published set to true to publish the post immediately (default) or false to publish later". Tuż pod tym wierszem: "Include scheduled_publish_time if set to false".
Przykładowe żądanie z tego przewodnika wygląda tak:
curl -X POST "https://graph.facebook.com/v25.0/page_id/feed" \
-H "Content-Type: application/json" \
-d '{
"message":"your_message_text",
"link":"your_url",
"published":"false",
"scheduled_publish_time":"unix_time_stamp_of_a_future_date",
}'Po powodzeniu odpowiedź zawiera identyfikator posta, który istnieje, ale nie pojawił się jeszcze na stronie: {"id": "page_post_id"}. Dalej omawiamy trzy rzeczy decydujące o tym, czy to żądanie zadziała: flagę published, format czasu i wyprzedzenie.
Czy scheduled_publish_time wymaga published=false?
Tak. Zaplanowany post na stronie to nieopublikowany post z przypisaną datą, więc oba parametry idą w parze. Jeśli zostawisz published z domyślną wartością true, post ukaże się od razu.
Zdjęcia wymagają dodatkowego kroku. Dokumentacja Page Photos mówi, że zdjęcie użyte w zaplanowanym poście musi zostać przesłane z temporary=true, a ten parametr opisuje jednym zdaniem: "published must be false, and you can't set scheduled_publish_time". Termin ustawia się w poście w kanale, który dołącza zdjęcia, a nie w samych zdjęciach. O poście z wieloma zdjęciami Meta pisze: "When the photos are part of a scheduled post, the published, scheduled_publish_time, and unpublished_content_type parameters must be included." Jej przykład wysyła do /feed wartości published=false, scheduled_publish_time=1512068400 i unpublished_content_type=SCHEDULED.
Prześlij te zdjęcia krótko przed utworzeniem posta. Meta podaje, że nieopublikowany plik "will remain on Facebook servers for about 24 hours. If you do not publish these photos within 24 hours, we delete them."
Zanim skopiujesz kod z dokumentacji Page Feed, warto znać jedną jej pomyłkę. Tabela parametrów nazywa flagę published, a sekcja "Posting a Link to a Page" każe "Set the publish parameter to 1 to publish the post immediately or to 0 to create an unpublished post to be published later". Przykładowe żądanie pod tym zdaniem wysyła published=1. Używaj published.

Jakie formaty czasu przyjmuje scheduled_publish_time?
Przewodnik po postach w Pages API wymienia trzy formaty:
| Format | Przykład Meta |
|---|---|
| "An integer UNIX timestamp [in seconds]" | 1530432000 |
| Ciąg znacznika czasu ISO 8601 | 2018-09-01T10:15:30+01:00 |
"Any string otherwise parsable by PHP's strtotime()" | +2 weeks, tomorrow |
Tekst linku w przewodniku zapisuje nazwę standardu jako "ISO 8061". Sam link prowadzi do ISO 8601, a przykład jest poprawnym ciągiem ISO 8601, więc to literówka.
Strony dokumentacji są węższe niż przewodnik. Page Feed określa typ parametru jako timestamp i nazywa go "UNIX timestamp indicating when post should go live." Page Photos i Page Videos podają typ int64. Tylko przewodnik wspomina o ciągach znaków. Liczba całkowita UNIX w sekundach to jedyny format akceptowany przez wszystkie strony, więc wysyłaj właśnie ją. Date.now() w JavaScript zwraca milisekundy, czyli liczbę 1 000 razy za dużą, dlatego przed wysłaniem ją podziel.
Jeśli używasz ciągu względnego, Meta podpowiada, jak sprawdzić wynik: "If you are relying on strtotime()'s relative date strings you can read-after-write the scheduled_publish_time of the created post to make sure it is what is expected." Znaczenie tomorrow zależy od tego, jaki zegar serwera i jaka strefa czasowa go interpretują, a Meta nie mówi nic o żadnym z nich.
Odczyt wartości ma własną osobliwość. Na liście pól w dokumentacji Page Feed pole do odczytu jest zapisane jako sheduled_publish_time, bez litery "c", z typem float. Dokumentacja Page Post zapisuje je poprawnie: scheduled_publish_time. Proś o poprawną pisownię.
Z jakim wyprzedzeniem można planować przez scheduled_publish_time?
Co najmniej 10 minut. Maksimum zależy od tego, którą stronę Meta czytasz, a strony są ze sobą sprzeczne.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
| Strona Meta | Punkt końcowy | Minimum | Maksimum | Sformułowanie Meta |
|---|---|---|---|---|
| Pages API, przewodnik Posts | /{page-id}/feed | 10 minut | 30 dni | "The publish date must be between 10 minutes and 30 days from the time of the API request." |
| Dokumentacja Page Feed, parametr publikacji | /{page-id}/feed | 10 minut | 75 dni | "Must be date between 10 minutes and 75 days from the time of the API request." |
| Dokumentacja Page Feed, pole do odczytu | /{page-id}/feed | 10 minut | 75 dni | "Date will be between 10 minutes and 75 days from the time of the POST request to publish the post." |
| Dokumentacja Page Videos | /{page-id}/videos | 10 minut | 6 miesięcy | "this should be between 10 mins and 6 months from the time of publishing the video." |
| Przewodnik publikowania Reels | /{page-id}/video_reels | 10 minut | 29 dni | "the publish time must be greater than 10 minutes from the current time and within 29 days of the current date, and video_state must be set to 'SCHEDULED'." |
| Dokumentacja Page Photos | /{page-id}/photos | Nie podano | Nie podano | "Time at which an unpublished post should be published (Unix timestamp). Applies to Pages only" |
Minimum 10 minut to jedyna liczba, co do której wszystkie są zgodne. Na Mastodonie dolna granica jest o połowę niższa, a dokumentacja ujmuje to jednym zdaniem, "Must be at least 5 minutes in the future", co wyjaśnia, dlaczego scheduled_at w API Mastodona wymaga 5 minut wyprzedzenia.
Największe znaczenie ma rozbieżność dotycząca /feed, bo przechodzą przez niego posty tekstowe, posty z linkami i zaplanowane posty z wieloma zdjęciami. Dwie strony Meta podają dwa limity dla tego samego parametru w tym samym punkcie końcowym: przewodnik mówi o 30 dniach, dokumentacja o 75. Żadna z nich nie wskazuje, która wartość obowiązuje, ani nie wspomina o drugiej liczbie. Narzędzie dopuszczające 75 dni zadziała, jeśli rację ma dokumentacja, a jeśli przewodnik, zawiedzie gdzieś między 31. a 75. dniem. Narzędzie z limitem 30 dni działa w obu przypadkach. Ustaw limit na 30.
Warto przyjrzeć się też liczbie dla wideo. Strony o kanale liczą od "the time of the API request". Dokumentacja wideo liczy od "the time of publishing the video", co jest niejednoznaczne dla filmu, którego przesyłanie kończy się kilka minut po rozpoczynającym je żądaniu. Zostaw margines z obu stron.
Dokumentacje zdjęć i wideo wymieniają też więcej stanów nieopublikowanych, niż wyjaśniają. Obie podają wartości unpublished_content_type, w tym SCHEDULED, SCHEDULED_RECURRING, DRAFT i PUBLISH_PENDING, ale żadna nie mówi, co robi SCHEDULED_RECURRING. Trzymaj się SCHEDULED.
Jaki błąd zwraca Meta, gdy czas jest poza zakresem?
Meta żadnego nie publikuje. Żadna z powyższych stron nie cytuje komunikatu dla zbyt wczesnego lub zbyt późnego scheduled_publish_time. Dokumentacje Page Videos i Page Post wymieniają błąd 100, "Invalid parameter", jako ogólny błąd walidacji i na tym kończy się precyzja dokumentacji Meta.
Obsługę błędów oprzyj na kodzie. Dokumentacja błędów Marketing API podaje powód jednym zdaniem: "Error handling should be done using only the Error Codes. The Description string is subject to change without prior notice." Zapisuj pola message i fbtrace_id na potrzeby debugowania, ale logikę ponawiania opieraj na code. Przewodnik Meta po obsłudze błędów opisuje fbtrace_id jako "Internal support identifier", czyli wartość, którą należy podać pomocy technicznej Meta.
Odrzucenie z powodu okna czasowego nie nadaje się też do ponawiania. Powtórzenie żądania wyśle ten sam błędny znacznik czasu i zwróci to samo 100. Sprawdź okno przed wywołaniem: dla /feed co najmniej 10 minut i najwyżej 30 dni naprzód, licząc według zegara serwera w sekundach UTC. YouTube planuje przesyłanie przez inne pola, które zawodzą w inny sposób, a każde pole w procesie planowania na YouTube i jego błędy omawiamy osobno.

Jak zmienić lub anulować zaplanowany post na Facebooku?
Zaktualizuj go żądaniem POST do /{page_post_id} albo usuń żądaniem DELETE pod tą samą ścieżką. Parametry aktualizacji w dokumentacji Page Post obejmują scheduled_publish_time i is_published, ale tabela nie opisuje ich niczym poza nazwą. Przewodnik Pages API dodaje jedno ograniczenie: "An app can only update a Page post if the post was made using that app." Zgodnie z tą zasadą twoja aplikacja nie może edytować posta zaplanowanego w Meta Business Suite.
Aby znaleźć zaplanowane posty, odczytaj /{page-id}/feed z polem is_published. Dokumentacja Page Feed mówi to wprost: "Published and unpublished posts will be returned when querying the /{page-id}/feed endpoint. Use the 'is_publishedfield to return only published posts." Meta definiuje to pole jako takie, które "Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instantly published posts this value is alwaystrue`)."
To zachowanie kanału zaskakuje osoby synchronizujące posty strony z bazą danych. Zadanie, które czyta /feed bez is_published, zbiera zaplanowane posty tak, jakby były już opublikowane. Zawsze pobieraj to pole i filtruj według niego. To, jak różne narzędzia udostępniają tę funkcję w wielu sieciach, pokazuje porównanie dziewięciu API do planowania w mediach społecznościowych.
Najczęściej zadawane pytania
Jakie jest minimalne wyprzedzenie dla scheduled_publish_time na Facebooku?
Dziesięć minut. Przewodnik po postach w Pages API i dokumentacja Page Feed liczą to minimum od momentu żądania API, dokumentacja Page Videos od momentu publikacji filmu, a przewodnik publikowania Reels wymaga czasu odległego o ponad 10 minut. Dokumentacja Page Photos nie podaje żadnego zakresu.
Jakie jest maksymalne okno planowania posta na stronie przez API?
Meta podaje dwie liczby dla /feed. Przewodnik po postach w Pages API mówi o 30 dniach, a dokumentacja Page Feed o 75. Dla filmów w /{page-id}/videos dokumentacja Page Videos podaje 6 miesięcy, a dla Reels w /{page-id}/video_reels przewodnik publikowania Reels 29 dni. Limit 30 dni dla postów w kanale działa niezależnie od tego, która strona ma rację.
Czy trzeba ustawić published=false, aby użyć scheduled_publish_time?
Tak. Przewodnik Meta uzależnia scheduled_publish_time od wartości false w published. Przy domyślnym true post ukaże się natychmiast.
Czy scheduled_publish_time może być ciągiem daty ISO 8601?
Przewodnik po postach w Pages API akceptuje ISO 8601, z przykładem 2018-09-01T10:15:30+01:00, a także ciągi strtotime(), takie jak +2 weeks. Strony dokumentacji określają typ pola jako znacznik czasu UNIX lub int64, więc liczba całkowita w sekundach jest najbezpieczniejsza.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jaki błąd zwraca Graph API dla scheduled_publish_time poza oknem?
Meta nie dokumentuje konkretnego komunikatu. Dokumentacje Page Videos i Page Post wymieniają kod 100, "Invalid parameter", jako ogólny błąd walidacji. Obsługuj kod i zapisuj komunikat, bo Meta ostrzega, że opisy mogą się zmieniać bez uprzedzenia.
Jak wyświetlić przez API zaplanowane posty strony na Facebooku?
Odpytaj /{page-id}/feed i pobierz pole is_published. Meta zwraca tam razem posty opublikowane i nieopublikowane, a dla posta wciąż zaplanowanego is_published ma wartość false.
Czy scheduled_publish_time podaje się w sekundach, czy w milisekundach?
W sekundach. Przewodnik Pages API wymaga całkowitego znacznika czasu UNIX w sekundach. Date.now() w JavaScript zwraca milisekundy, czyli liczbę 1 000 razy za dużą, więc przed wysłaniem podziel ją przez 1 000.
Czy scheduled_publish_time używa UTC, czy mojej strefy czasowej?
Znacznik czasu UNIX w sekundach oznacza jeden konkretny moment, więc nie zawiera strefy czasowej. Meta nie mówi, jaki zegar lub strefa interpretuje ciąg taki jak tomorrow, dlatego wysyłaj liczbę całkowitą. Minimum 10 minut i górny limit sprawdzaj według zegara serwera w sekundach UTC.
Czy przez API można edytować post zaplanowany w Meta Business Suite?
Własną aplikacją nie. Przewodnik Pages API mówi "An app can only update a Page post if the post was made using that app", więc posta zaplanowanego w Meta Business Suite twoja aplikacja nie zmieni. Posty utworzone przez aplikację można aktualizować żądaniem POST do /{page_post_id}.
Czy scheduled_publish_time działa z Reels na Facebooku?
Tak, z dwiema różnicami. Reels przechodzą przez /{page-id}/video_reels, a pole przyjmuje tylko znacznik czasu Unix. Łączy się ono z video_state=SCHEDULED zamiast published=false, a przewodnik publikowania Reels wymaga czasu odległego o ponad 10 minut i mieszczącego się w 29 dniach.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Trzy odpowiedzi na pytanie, jak długie mogą być Reels na Facebooku
Jak długie mogą być Reels na Facebooku? W aplikacji dowolnie długie od 2025, przez API od 3 do 90 sekund, a w grupach 30 sekund, według stron samej Meta.


Czym jest token dostępu do Strony na Facebooku i dlaczego zaczyna się od człowieka
Token dostępu do Strony na Facebooku pozwala aplikacji działać jako Strona. Jak go zdobyć przez /accounts, jakich wymaga uprawnień i zadań oraz kiedy wygasa.


Jak limit business use case Mety rozlicza Strony na Facebooku
Limit business use case Mety dla Stron daje 4 800 wywołań na zaangażowanego użytkownika co 24 godziny przy tokenach Strony i użytkownika systemowego, a po przekroczeniu zwraca kod 80001.
Powiązane artykuły


Nagłówek x-app-usage od Meta to trzy procenty i żadnego zegara
Nagłówek x-app-usage od Meta podaje call_count, total_time i total_cputime jako procent godzinnego limitu Graph API aplikacji, bez czasu resetu.


Jak rolki próbne na Instagramie docierają do nieobserwujących przed twoimi obserwującymi
Rolki próbne na Instagramie trafiają najpierw do nieobserwujących, a do obserwujących dopiero po udostępnieniu. Wymagania, statystyki i ustawienie w API.


Jak działa tryb zdjęć na TikToku: 35 zdjęć i dwa pola tekstowe
Tryb zdjęć na TikToku pozwala dodać do 35 zdjęć w poście. Przez API każdy obraz to JPEG lub WebP do 20 MB, z tytułem do 90 runów i opisem do 4 000 runów.

