Słownik

Co pole creator_info max_video_post_duration_sec na TikToku mówi przed publikacją

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Odpowiedź creator info z TikToka pokazująca limity długości i prywatności dla kontaOdpowiedź creator info z TikToka pokazująca limity długości i prywatności dla konta

TL;DR, szybka odpowiedź

8 min czytania

POST /v2/post/publish/creator_info/query/ zwraca konto, na którym trafi post, poziomy prywatności, z których to konto naprawdę może korzystać, trzy flagi interakcji oraz max_video_post_duration_sec, które TikTok definiuje jako "The longest video duration in seconds that the TikTok creator can post. Different users have different maximum video-duration privileges." Media Transfer Guide TikToka podaje, że wszyscy twórcy mają 3 minuty, a niektórzy 5 lub 10, ale przykładowa odpowiedź Query Creator Info zwraca 300. Pole jest typu int32, bez udokumentowanego enuma i bez udokumentowanego minimum, centrum pomocy TikToka nie podaje żadnej liczby, a endpoint wymaga zakresu video.publish, więc klient z samym video.upload nie odczyta limitu, którego ma przestrzegać.

Co zwraca pole creator_info max_video_post_duration_sec na TikToku?

Pole creator_info max_video_post_duration_sec na TikToku zwraca najdłuższy film, podany w sekundach, jaki może opublikować ten konkretny twórca. Sformułowanie TikToka nie zostawia miejsca na globalną stałą:

"The longest video duration in seconds that the TikTok creator can post. Different users have different maximum video-duration privileges. Developers should use this field to stop video posts that are too long. IGNORE if your client only sends photo media through this API."

Wartość pochodzi z jednego endpointu, który w ogóle nie przyjmuje treści żądania:

URL HTTP/v2/post/publish/creator_info/query/
Metoda HTTPPOST
Zakresvideo.publish
Limit żądań"Each user access_token is limited to 20 requests per minute."

Token dostępu identyfikuje twórcę, więc to wywołanie jest odczytem danych konta, a nie wyszukiwaniem. TikTok opisuje cel endpointu jednym tchem z ekranem, który ma on zasilać: "When rendering the Export to TikTok page, your app must invoke the API and use the latest creator information returned to display the account's available privacy level options and video/photo interaction settings."

Co jeszcze zwraca endpoint creator info?

Osiem pól, a każde z nich ma zmieniać to, co pokazuje twój ekran publikacji:

PoleTypOpis TikToka
creator_avatar_urlstring"The URL of the TikTok creator's avatar with a TTL of 2 hours."
creator_usernamestring"The unique ID of the TikTok creator."
creator_nicknamestring"The nickname of the TikTok creator."
privacy_level_optionslist<string>Poziomy prywatności, spośród których to konto może wybierać
comment_disabledboolean"Returns true if the creator sets the comment interaction to "No one" in their privacy setting."
duet_disabledboolean"Returns true if the creator account is private or they set the Duet interaction to "No one" in their privacy setting."
stitch_disabledboolean"Returns true if the creator account is private or they set the Stitch interaction to "No one" in their privacy setting."
max_video_post_duration_secint32Najdłuższy film, jaki może opublikować ten twórca

Dwugodzinny TTL awatara łatwo przeoczyć, a powoduje on niedziałające obrazy na każdym ekranie, który zapisuje URL na czas całej sesji. Dwie flagi disabled łączą dwie różne przyczyny w jedną wartość logiczną: zarówno konto prywatne, jak i jawne ustawienie "No one" zwracają true, a odpowiedź nie pozwala ich rozróżnić.

Dlaczego maksymalna długość filmu zależy od twórcy?

Ponieważ TikTok przyznaje uprawnienia do długości filmów poszczególnym kontom, a nie całej platformie. Media Transfer Guide to jedyna strona, która podaje konkretne liczby:

"All TikTok creators can post 3-minute videos, while some have access to post 5-minute or 10-minute videos. The longest video a developer can send via the initialize Upload Video endpoint is 10 minutes. TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations."

Daje to udokumentowane minimum 180 sekund i udokumentowany pułap 600. Tymczasem przykładowa odpowiedź TikToka nie zwraca żadnej z tych wartości:

"max_video_post_duration_sec": 300

Trzysta sekund to środkowy poziom, czyli pięć minut. Przykład zgadza się z poziomami, ale nic w dokumentacji nie mówi, że pole może przyjmować wyłącznie 180, 300 i 600. Jest typu int32, bez enuma, więc klient rozgałęziający logikę na trzech zakodowanych na stałe wartościach opiera się na nieudokumentowanym założeniu. Porównuj odpowiedź z filmem, który masz, a nigdy ze stałą.

Centrum pomocy TikToka dla użytkowników też nie wypełnia tej luki. Artykuł "Making a post" zachęca twórców słowami "Select a maximum length for your video", ale nie podaje na stronie żadnej liczby, dlatego informacje z aplikacji o tym, jak długi może być film na TikToku, i informacje z API stale się rozjeżdżają. W integracji jedyną naprawdę wiarygodną liczbą jest pole z API, i to wyłącznie dla konta, którego tokenu użyto.

Telefon oparty na biurku pokazuje oś czasu edycji wideo, obok sekcji o opcjach poziomu prywatności.

Uprawnienia do długości według poziomu
Standard180 s
Przykładowa odpowiedź300 s
Pułap600 s
Media Transfer Guide TikToka wymienia trzy poziomy, a przykładowa odpowiedź Query Creator Info zwraca środkowy z nich.

Jakie opcje poziomu prywatności są zwracane razem z tym polem?

privacy_level_options zwraca inną listę w zależności od tego, czy konto jest publiczne, czy prywatne, a TikTok podaje obie:

Stan kontaZwracane opcje
PublicznePUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY
PrywatneFOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY

Wspólne dla obu list są tylko MUTUAL_FOLLOW_FRIENDS i SELF_ONLY. PUBLIC_TO_EVERYONE nigdy nie pojawia się dla konta prywatnego, a FOLLOWER_OF_CREATOR nigdy dla publicznego. Dokumentacja Direct Post wymienia wszystkie cztery wartości w enumie privacy_level bez tego podziału, więc integracje, które czytają enum zamiast odpowiedzi, kończą z wysyłaniem wartości niedostępnej dla konta.

Konsekwencja jest konkretna. Na etapie inicjalizacji wraca privacy_level_option_mismatch, a TikTok dołącza do tego ostrzeżenie: "All clients are required to correctly display the creator account's privacy level options and honor the users' choice. Occurances of this error for product-use applications suggest violations to TikTok's product-use guidance."

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Zasady UX są równie szczegółowe. TikTok wymaga, aby "Users must manually select the privacy status from a dropdown and there should be no default value", aby wyłączone interakcje były wyszarzone i aby żaden z przełączników komentarzy, Duet ani Stitch nie był domyślnie zaznaczony. W kwestii długości te same wytyczne mówią: "API clients must check if the duration of the to-be-posted video follows the max_video_post_duration_sec returned in the creator_info API." Samo odczytanie wartości nie oznacza zgodności. Liczy się zablokowanie posta.

Klienci bez audytu mają jeszcze krótszą listę. TikTok ogranicza ich do widoczności SELF_ONLY oraz do "up to 5 users to post in a 24 hour window", przy czym każde z tych kont musi być w chwili publikacji prywatne.

Czego TikTok nie rozstrzyga

Te luki lepiej mieć na liście kontrolnej, niż odkrywać je na produkcji.

Zakres nie pasuje do przepływu. Query Creator Info wymaga zakresu video.publish. Endpoint Upload pod adresem /v2/post/publish/inbox/video/init/ wymaga video.upload. Klient, który tylko wrzuca szkice do skrzynki twórcy, ma więc token niepozwalający wywołać endpointu, którego wartości TikTok każe mu przestrzegać. TikTok nigdzie nie odnosi się do tej sprzeczności. Najbliższe rozwiązania jest zdanie o przycinaniu z Media Transfer Guide, bo zbyt długi film wysłany do skrzynki trafia do twórcy do przycięcia, zamiast zostać od razu odrzucony.

Odmowa może przyjść jako HTTP 200. Tabela błędów creator info wymienia spam_risk_too_many_posts, spam_risk_user_banned_from_posting i reached_active_user_cap pod statusem HTTP "200 (intentional)". Klient, który patrzy tylko na kody statusu, uzna to za sukces i pokaże ekran publikacji, z którego nie da się nic opublikować. Zalecenie TikToka jest jasne: "When the creator_info API returns that the creator can not make more posts at this moment, API Clients must stop the current publishing attempt and prompt users to try again later."

Limit publikacji jest opisany, ale nie podany. TikTok pisze: "There is a limit on the number of posts that can be made to a creator account in a 24-hour window via Direct Post API. The upper limit may vary among creators (typically around 15 posts per day/ creator account) and is shared across all API Clients using Direct Post." Żadne pole nie zwraca tej liczby, a "typically around" to cała precyzja, jaką oferuje TikTok. To słabsza deklaracja niż konkretna wartość stojąca za limitem publikacji treści na Instagramie.

Nie ma udokumentowanego minimum. Dokumentacja API podaje maksymalną długość dla twórcy i nic na temat dolnej granicy. Zbyt krótki film wychodzi na jaw dopiero po fakcie, jako powód niepowodzenia duration_check_failed z /v2/post/publish/status/fetch/, opisany słowami "Video does not meet our duration restrictions."

Traktuj wywołanie creator info jako część każdej publikacji, a nie wdrożenia. Opcje prywatności, flagi interakcji i limit długości zmieniają się, gdy twórca zmieni ustawienie, dlatego każde narzędzie, które planuje posty na TikToku, musi odpytywać API w chwili publikacji, zamiast używać danych zapisanych w zeszłym tygodniu. Dołączany opis podlega osobnej regule, czyli pułapowi 2 200 runów UTF-16 omówionemu w tekście o limicie znaków w opisie na TikToku.

Najczęściej zadawane pytania

Zbliżenie stopera ilustrujące pytanie o wartości długości filmu zwracane przez TikToka.

Czy max_video_post_duration_sec może zwrócić coś innego niż 180, 300 lub 600?

TikTok nie obiecuje tych trzech wartości. Pole jest typu int32, dokumentacja nie podaje enuma, a uprawnienia 3, 5 i 10 minut wymienia tylko Media Transfer Guide. Porównuj film ze zwróconą liczbą, a nie z zakodowanym na stałe zestawem.

Co się stanie, jeśli opublikuję film dłuższy niż zwrócony limit?

W Direct Post zadanie zakończy się niepowodzeniem z powodem duration_check_failed. W przypadku endpointu Upload TikTok podaje, że "TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations", więc twórca rozwiązuje problem podczas edycji.

Czy integracja obsługująca tylko zdjęcia może zignorować to pole?

Tak, i TikTok mówi o tym wprost. max_video_post_duration_sec, duet_disabled i stitch_disabled mają adnotację "IGNORE if your client only sends photo media through this API."

Jak często mogę wywoływać endpoint creator info?

Dwadzieścia razy na minutę na token dostępu użytkownika. To najwyższy opublikowany limit wśród endpointów publikacji, które pozwalają na 6 żądań na minutę przy inicjalizacji i 30 przy sprawdzaniu statusu.

Dlaczego duet_disabled ma wartość true, choć twórca nie wyłączył Duet?

Bo konto prywatne ustawia tę samą flagę. TikTok zwraca true, jeśli "the creator account is private or they set the Duet interaction to "No one" in their privacy setting", a odpowiedź nie pozwala odróżnić tych dwóch przyczyn.

Czy endpoint informuje, czy konto jest publiczne, czy prywatne?

Nie w osobnym polu, ale zdradza to privacy_level_options. Lista z PUBLIC_TO_EVERYONE należy do konta publicznego, a lista z FOLLOWER_OF_CREATOR do prywatnego, ponieważ te dwie wartości nigdy nie występują razem.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy muszę odpytywać creator info przed każdym postem, czy tylko raz przy wdrożeniu?

Przy każdej publikacji, nie przy wdrożeniu. Opcje prywatności, flagi interakcji i limit długości zmieniają się, gdy twórca zmieni ustawienie, więc wartość pobrana w zeszłym tygodniu może być już nieaktualna. Narzędzia planujące posty na TikToku z wyprzedzeniem muszą odpytywać API w chwili publikacji, zamiast używać zapisanej odpowiedzi.

Co się stanie, jeśli moja aplikacja pozwoli wybrać poziom prywatności spoza privacy_level_options?

TikTok zwróci błąd privacy_level_option_mismatch na etapie inicjalizacji. W aplikacjach do użytku produkcyjnego powtarzanie się tego błędu TikTok traktuje jako znak naruszania wytycznych, ponieważ klienci muszą wyświetlać wyłącznie opcje prywatności faktycznie dostępne dla konta.

Jakie dodatkowe limity dotyczą aplikacji TikToka, która nie przeszła jeszcze audytu?

TikTok ogranicza klientów bez audytu do poziomu prywatności SELF_ONLY i do publikowania dla maksymalnie 5 użytkowników w ciągu 24 godzin. Każde z tych kont musi być w chwili publikacji prywatne.

Czy TikTok podaje dokładny dzienny limit publikacji na konto twórcy?

TikTok nigdy nie podaje dokładnej liczby. Opisuje limit wspólny dla wszystkich klientów API, który wynosi "typically around 15 posts per day/creator account" i może się różnić w zależności od twórcy, a żadne pole w odpowiedziach nie zwraca tej wartości.

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