Słownik

Wyprzedzenie w API platform: z jakim wyprzedzeniem można zaplanować post?

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Z jakim wyprzedzeniem można zaplanować post w API każdej platformyZ jakim wyprzedzeniem można zaplanować post w API każdej platformy

TL;DR, szybka odpowiedź

8 min czytania

Tylko cztery sieci przyjmują przez API przyszły czas publikacji. Facebook wymaga co najmniej 10 minut, a maksimum wynosi 30 dni, 75 dni, 6 miesięcy lub 29 dni, zależnie od strony dokumentacji Meta i endpointu. Mastodon wymaga co najmniej 5 minut i nie podaje maksimum. YouTube nie dokumentuje dla publishAt ani minimum, ani maksimum. X Ads API pozwala planować Tweety do roku naprzód. Instagram, Threads, LinkedIn, TikTok, Pinterest, Bluesky i X API v2 nie mają pola planowania, więc narzędzie przechowuje post i publikuje go o wybranej porze.

Z jakim wyprzedzeniem można zaplanować post w API każdej platformy?

W oficjalnych API wyprzedzenie zależy od sieci: posty na stronach na Facebooku przyjmują od 10 minut do 30 dni, Mastodon wymaga co najmniej 5 minut bez udokumentowanego górnego limitu, a Instagram, LinkedIn, TikTok, Threads i Pinterest w ogóle nie przyjmują przyszłego czasu. Każda komórka poniżej pochodzi z dokumentacji danej platformy. „Brak w dokumentacji” oznacza, że strona platformy poświęcona temu polu nie podaje limitu.

Platforma, endpoint i poleMinimalne wyprzedzenieMaksymalne wyprzedzenieStrona źródłowa
Post na stronie na Facebooku, /{page-id}/feed, scheduled_publish_time"between 10 minutes and 30 days"30 dniPages API, przewodnik Posts
Post na stronie na Facebooku, /{page-id}/feed, scheduled_publish_time"between 10 minutes and 75 days"75 dniGraph API, dokumentacja Page Feed
Film na stronie na Facebooku, /{page-id}/videos, scheduled_publish_time"between 10 mins and 6 months"6 miesięcyGraph API, dokumentacja Page Videos
Reel na Facebooku, /{page-id}/video_reels, scheduled_publish_time"greater than 10 minutes from the current time""within 29 days of the current date"Video API, przewodnik Reels Publishing
YouTube, videos.insert lub videos.update, status.publishAtBrak w dokumentacjiBrak w dokumentacjiYouTube Data API, zasób videos
Mastodon, POST /api/v1/statuses, scheduled_at"at least 5 minutes in the future"Brak w dokumentacjiMastodon API, metody statuses
X Ads API, POST accounts/:account_id/scheduled_tweets, scheduled_atBrak w dokumentacji"up to one year in the future"X Ads API, dokumentacja Creatives
X API v2, POST /2/tweetsBrak pola planowaniaBrak pola planowaniaX API, Create Posts
Instagram, /<IG_ID>/media i /<IG_ID>/media_publishBrak pola planowaniaBrak pola planowaniaInstagram Platform, Content Publishing
Threads, /{threads-user-id}/threads i /threads_publishBrak pola planowaniaBrak pola planowaniaThreads API, dokumentacja Publishing
LinkedIn, POST /rest/postsBrak pola planowaniaBrak pola planowaniaLinkedIn Marketing, Posts API
TikTok, /v2/post/publish/video/init/Brak pola planowaniaBrak pola planowaniaTikTok Content Posting API, Direct Post
Pinterest, POST /v5/pinsBrak pola planowaniaBrak pola planowaniaSpecyfikacja OpenAPI Pinterest API v5, PinCreate
Bluesky, rekord app.bsky.feed.postBrak pola planowaniaBrak pola planowaniaLeksykon app.bsky.feed.post

Z tabeli wynikają dwie zasady. Minimum jest zawsze sprawdzane po stronie serwera według zegara platformy, nigdy twojego. Maksimum, jeśli istnieje, liczy się od chwili wysłania żądania do API, a nie od chwili przygotowania posta.

Kilka zegarów ściennych obok siebie pokazuje różne godziny, co symbolizuje sprzeczne maksymalne terminy podawane przez Meta dla Facebooka.

Dlaczego Meta podaje dla Facebooka cztery różne maksima?

Bo cztery strony Meta podają zakres dla scheduled_publish_time i żadne dwie nie zgadzają się co do górnej granicy. Minimum to konsekwentnie 10 minut. Z maksimum już tak nie jest.

Przewodnik Pages API mówi: "The publish date must be between 10 minutes and 30 days from the time of the API request." Dokumentacja Page Feed dla tego samego parametru w tym samym endpoincie /feed mówi: "UNIX timestamp indicating when post should go live. Must be date between 10 minutes and 75 days from the time of the API request." Dokumentacja Page Videos podaje, że czas publikacji filmu "should be between 10 mins and 6 months from the time of publishing the video." Przewodnik Reels Publishing mówi: "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'."

Żadna z tych stron nie mówi, która liczba obowiązuje, i żadna nie wspomina o pozostałych. Wartości 30 i 75 dni są sprzeczne w ramach jednego endpointu, więc narzędzie dopuszczające 75 dni działa tylko wtedy, gdy rację ma dokumentacja referencyjna. Jeśli rację ma przewodnik, każde żądanie po 30. dniu się nie powiedzie. Limit 30 dni dla postów w feedzie działa bez względu na to, która strona ma rację, a limit 29 dni dla Reels mieści się w jedynej liczbie, jaką Meta dla nich podaje. Pełny opis pola, jego formatów i błędów znajdziesz w tekście o oknie scheduled_publish_time na Facebooku.

Przewodnik po Reels dodaje drugi limit, ważny dla kolejek. Podaje, że Reels API "is limited to 30 API-published posts within a 24-hour moving period" oraz że "Meta recommends that your app also enforces the publishing rate limit, especially if your app allows app users to schedule posts to be published in the future."

Które platformy nie dokumentują maksymalnego wyprzedzenia?

YouTube i Mastodon. Na żadnej z tych stron nie ma górnej granicy, więc uczciwa odpowiedź brzmi: platforma jej nie publikuje.

Zasób videos w YouTube opisuje status.publishAt jako "The date and time when the video is scheduled to publish", dodaje, że "It can be set only if the privacy status of the video is private", i nie podaje ani minimum, ani maksimum. Opisuje natomiast, co dzieje się przy dolnej granicy: "If your request schedules a video to be published at some time in the past, the video will be published right away." YouTube nie ma więc minimalnego wyprzedzenia w sensie odrzucenia żądania. Czas z przeszłości oznacza publikację teraz. Zasady dotyczące prywatności i aktualizacji opisuje tekst o każdym polu publishAt w YouTube i jego błędach.

Mastodon dokumentuje dolną granicę i na tym poprzestaje. Parametr scheduled_at w POST /api/v1/statuses to "Datetime at which to schedule a status", który "Must be at least 5 minutes in the future." Strona nie podaje maksimum. Kod serwera rygorystycznie pilnuje tej granicy i dodaje limity na konto, których dokumentacja nie wymienia. Wszystko opisujemy w tekście o tym, dlaczego scheduled_at w API Mastodona wymaga 5 minut wyprzedzenia.

Które platformy w ogóle nie mają pola planowania?

Instagram, Threads, LinkedIn, TikTok, Pinterest, Bluesky i X API v2. We wszystkich siedmiu przypadkach zaplanowany post to taki, który narzędzie przechowuje na własnych serwerach i publikuje zwykłym wywołaniem tworzenia, gdy nadejdzie pora. Platforma widzi wyłącznie natychmiastową publikację.

Dokumentacje mówią o tym na różne sposoby. Posts API LinkedIna podaje o lifecycleState: "PUBLISHED is the only accepted field during creation." Przewodnik Content Publishing Instagrama zakłada, że czekaniem zajmuje się aplikacja. Prosi aplikacje, by same pilnowały limitu publikacji, "especially if your app allows app users to schedule posts to be published in the future." Schemat PinCreate w specyfikacji OpenAPI v5 Pinteresta wymienia ai_disclosures, alt_text, board_id, board_section_id, description, dominant_color, link, media_source, parent_pin_id, sponsor_id i title, bez pola czasu. Treść żądania POST /2/tweets w X API v2 również go nie ma. Rekord posta na Bluesky ma createdAt, ale leksykon nazywa je "Client-declared timestamp when this post was originally created", a nie czasem publikacji.

Bez kolejki po stronie platformy liczy się czas życia obiektów pośrednich. Nie da się ich przygotować wiele dni wcześniej:

PlatformaObiektUdokumentowana reguła czasowa
InstagramKontener multimediówEXPIRED: "The container was not published within 24 hours and has expired."
TikTokupload_url z /v2/post/publish/video/init/"valid for one hour after issuance"
ThreadsKontener multimediówMeta zaleca odczekać "on average 30 seconds before publishing"

Narzędzie planujące post na Instagramie na przyszły miesiąc samo przechowuje więc multimedia i opis. Kontener tworzy blisko terminu publikacji i publikuje go w ciągu 24 godzin od utworzenia. W tych siedmiu sieciach to, jak daleko naprzód możesz planować, zależy od narzędzia, a nie od API.

Planowanie posta na Instagramie na przyszły miesiąc
1
Zapis. Narzędzie trzyma multimedia i opis na własnych serwerach.
2
Oczekiwanie. Instagram niczego nie widzi, bo jego endpointy nie przyjmują czasu publikacji.
3
Utworzenie kontenera. Zrób to blisko terminu publikacji, bo nieopublikowany kontener wygasa po 24 godzinach.
4
Publikacja. Użyj zwykłego wywołania tworzenia w ciągu 24 godzin od utworzenia kontenera.
Instagram widzi tylko ostatni krok, a 24-godzinny licznik kontenera startuje w kroku 3.

Na co X Ads API pozwala przy planowaniu Tweetów?

Do roku naprzód, z dokładnością do minuty i tylko dla reklamodawców. Parametr scheduled_at w POST accounts/:account_id/scheduled_tweets to "The time, expressed in ISO 8601, that the Tweet should be published (or go live)", z dwiema uwagami: "Tweets can only be scheduled up to one year in the future" oraz "Tweets should only be scheduled at minute-granularity; seconds will be ignored."

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

W ustawieniach domyślnych kryje się pułapka. Parametr nullcast tego endpointu ma domyślnie wartość true, co dokumentacja definiuje jako utworzenie "a nullcasted (or 'Promoted-only') Tweet." Zaplanowany Tweet utworzony z ustawieniami domyślnymi nie pojawi się na osi czasu profilu jako post organiczny. Endpoint wymaga też as_user_id, a reklamodawca "must grant your handle (or handles) access to their ads account via ads.x.com." To inna konfiguracja niż przy publikacji organicznej, która przechodzi przez POST /2/tweets i nie ma pola planowania.

Dłoń zakreśla datę w papierowym kalendarzu ściennym, co pokazuje stałe okno, które narzędzie musi sprawdzić przed wysłaniem posta.

Jakie okno wyprzedzenia powinno egzekwować narzędzie do planowania?

Egzekwuj najbardziej rygorystyczną udokumentowaną granicę dla każdej platformy, mierzoną według zsynchronizowanego zegara serwera, i odrzucaj wszystko spoza niej przed wywołaniem API. Wczesne odrzucenie daje użytkownikowi zrozumiały komunikat zamiast ogólnego błędu 100 lub 422.

PlatformaCo najmniejCo najwyżej
Posty w feedzie na Facebooku10 minut plus margines zegara30 dni
Reels na Facebooku10 minut plus margines zegara29 dni
Filmy na Facebooku10 minut plus margines zegara6 miesięcy
Mastodon5 minut plus margines zegaraBrak limitu platformy
YouTubeDowolny czas w przyszłości; blokuj czasy z przeszłościBrak limitu platformy
Zaplanowane Tweety w X AdsBrak dolnej granicy platformyRok

Margines jest ważny, bo każde z tych minimów sprawdzane jest według zegara platformy w chwili nadejścia żądania. Post ustawiony na 10 minut i 5 sekund naprzód może zostać odrzucony, jeśli żądanie idzie wolno albo lokalny zegar się spóźnia. W sieciach bez pola planowania wyprzedzenie zależy od narzędzia, a jedynym terminem platformy jest czas życia obiektu z poprzedniej tabeli.

Najczęściej zadawane pytania

Z jakim wyprzedzeniem można zaplanować post na Facebooku przez API?

Przewodnik Pages API Meta mówi o przedziale od 10 minut do 30 dni, a dokumentacja Page Feed dla tego samego pola /feed o przedziale od 10 minut do 75 dni. Filmy na stronach można planować do 6 miesięcy, a Reels do 29 dni. Limit 30 dni dla postów w feedzie mieści się w obu wartościach.

Czy można planować posty na Instagramie przez API Instagrama?

Nie po stronie platformy. Endpointy Content Publishing /<IG_ID>/media i /<IG_ID>/media_publish nie przyjmują czasu publikacji, więc narzędzie przechowuje post i publikuje go w wybranym momencie. Kontenery wygasają, jeśli są "not published within 24 hours".

Czy YouTube ma maksymalny czas planowania?

Zasób videos Google'a nie dokumentuje go dla status.publishAt. Podaje jedynie, że pole "can be set only if the privacy status of the video is private" i że czas z przeszłości publikuje film "right away".

Jakie jest najkrótsze wyprzedzenie przyjmowane przez API platform?

Udokumentowane minimum Mastodona to "at least 5 minutes in the future". Facebook wymaga 10 minut na każdej stronie Meta, która podaje zakres dla scheduled_publish_time. Dokumentacja Page Photos nie podaje żadnego zakresu. YouTube nie dokumentuje dolnej granicy i czasy z przeszłości publikuje natychmiast.

Czy API LinkedIna obsługuje planowanie postów?

Nie. Posts API mówi o lifecycleState, że "PUBLISHED is the only accepted field during creation", a żądanie tworzenia nie ma pola czasu. Narzędzia planujące posty na LinkedInie przechowują je i wywołują POST /rest/posts o wybranej porze.

Jak daleko naprzód można zaplanować Tweeta przez API?

Pole planowania ma tylko X Ads API. Jego endpoint scheduled_tweets dopuszcza terminy "up to one year in the future", ignoruje sekundy, a nullcast ma domyślnie wartość true, co czyni Tweeta wyłącznie promowanym. Endpoint POST /2/tweets w X API v2 nie ma pola planowania.

Jak daleko naprzód można zaplanować reel na Facebooku przez API?

Przewodnik Reels Publishing mówi, że czas publikacji musi być o ponad 10 minut późniejszy od bieżącego i mieścić się w 29 dniach od bieżącej daty, a video_state musi mieć wartość "SCHEDULED". Reels mają też limit 30 postów publikowanych przez API w ruchomym okresie 24 godzin. Meta zaleca, by aplikacja umożliwiająca planowanie również pilnowała tego limitu.

Czy API Mastodona ma maksymalny czas planowania?

Dokumentacja go nie podaje. Wymaga jedynie, by scheduled_at wypadało co najmniej 5 minut w przyszłości. Kod serwera dodaje limity na konto, których dokumentacja nie wymienia, więc narzędzie nie powinno zakładać nieograniczonej kolejki.

Czy można planować posty na Threads lub TikToku przez ich API?

Żadna z tych platform nie ma pola planowania, więc narzędzie przechowuje post i publikuje go o wybranej porze. Reguły czasowe dotyczą za to obiektów pośrednich. upload_url TikToka z /v2/post/publish/video/init/ jest ważny przez godzinę od wydania, a Meta zaleca odczekać średnio 30 sekund przed opublikowaniem kontenera multimediów Threads.

Dlaczego post na Facebooku zaplanowany dokładnie 10 minut naprzód może się nie udać?

Każde minimum jest sprawdzane według zegara platformy w chwili nadejścia żądania. Post ustawiony na 10 minut i 5 sekund naprzód może zostać odrzucony, jeśli żądanie idzie wolno albo lokalny zegar się spóźnia. Dodaj margines zegara do 10-minutowego minimum i odrzucaj wszystko spoza okna przed wywołaniem API.

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

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

Powiązane artykuły