Postavke TikTok objava putem API-ja: privatnost, komentari, Duet i Stitch
TikTokov API za poslovne račune prima postavke objave u pozivu za objavu, uglavnom unutar post_info. Videozapisi primaju disable_comment, disable_duet i disable_stitch, naslovnicu iz thumbnail_offset ili custom_thumbnail_url, oznake is_brand_organic i is_branded_content te is_ai_generated. Objave fotografija primaju privacy_level, disable_comment, iste oznake marke i auto_add_music. GET /business/video/settings/ vraća vrijednosti koje svaki račun dopušta.
easyCoexistence objavljuje TikTok videozapise i objave fotografija pomoću funkcije publish_tiktok_post iz Claudea, ChatGPT-ja ili vašeg koda, s tekstom, naslovom objave fotografije te uključenim ili isključenim komentarima, a get_social_credentials daje vašem kodu token za čitanje dopuštenih postavki računa.
Opcije privatnosti za objave fotografija javnog računa: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
Razina privatnosti koju privatni račun dobiva umjesto PUBLIC_TO_EVERYONE: vidljivo samo njegovim pratiteljima.
Zadana vrijednost za disable_comment, disable_duet i disable_stitch, pa komentari, Duet i Stitch ostaju uključeni dok se ne postave.
Najveća prilagođena slika naslovnice za videozapis mora biti najmanje 360 x 360 piksela i najviše 20 MB.
Oznaka is_branded_content se pridružuje; ima prednost kad je is_brand_organic također true.
Obvezno polje post_info objave fotografija, ograničeno na opcije koje GET /business/video/settings/ vraća za račun.
Koje postavke prima svaki endpoint za objavu?
/business/video/publish/ i /business/photo/publish/ dijele neke postavke, a razlikuju se u drugima. Većina je unutar post_info, dok su custom_thumbnail_url i photo_cover_index na najvišoj razini tijela zahtjeva. Jedno pored drugoga, kako ih navode TikTokove reference, uz oznaku nema polja tamo gdje endpoint za tu postavku ne dokumentira ništa:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
Što račun dopušta?
GET /business/video/settings/ uz business_id vraća ograničenja računa za njegove objave. Pročitajte ih prije objave, jer TikTok prihvaća samo vrijednosti koje navodi:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSiSELF_ONLYza javni račun;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSiSELF_ONLYza privatni.comment_disabled: true kad račun ne prima komentare ni od koga, i tadadisable_commentprihvaća samo true.duet_disabledistitch_disabled: true kad račun dopušta Duet ili Stitch samo za »Only you« ili je privatan; odgovarajuća sklopka tada prihvaća samo true.max_video_post_duration_sec: najdulji videozapis koji račun može objaviti; dulji videozapis ne prolazi.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Tko može vidjeti objavu?
Kod objave fotografija, privacy_level koji šaljete: PUBLIC_TO_EVERYONE za ljude na TikToku i izvan njega, MUTUAL_FOLLOW_FRIENDS za pratitelje koje račun prati uzvratno, FOLLOWER_OF_CREATOR za pratitelje privatnog računa ili SELF_ONLY. Endpoint za videozapise nema polje za privatnost, jer objavljuje javne videozapise. Objava postavljena na »Friends« ili »Only you« ne može se gledati ni putem svog embed_url-a.
Kako rade komentari, Duet i Stitch?
Svaka je to sklopka koja isključuje značajku kad se postavi na true. disable_comment postoji na oba endpointa, a disable_duet i disable_stitch samo na videozapisima. Sve su zadane na false, što ostavlja značajku uključenom, unutar onoga što dopuštaju vlastite postavke privatnosti računa: račun koji ne prima komentare ni od koga ili ograničava Duet ili Stitch na »Only you« može objaviti samo uz tu sklopku postavljenu na true.
Kako se bira naslovnica?
Kod videozapisa postoje dva načina. post_info.thumbnail_offset bira kadar prema vremenu u milisekundama, zadano 0, zaokruženo na najbliži kadar; vrijeme nakon kraja videozapisa šalje webhook o neuspjehu i videozapis se ne objavljuje. custom_thumbnail_url, na najvišoj razini tijela zahtjeva, daje sliku umjesto toga, zbog čega TikTok zanemaruje offset. Kod objave fotografija, photo_cover_index bira jednu od slika, brojeno od 0.
- Prilagođena slika naslovnice: JPG, JPEG, WebP ili PNG, do 20 MB.
- Veličina: od 360 x 360 piksela do 1080 x 1920 ili 1920 x 1080.
- Lokacija: domena ili prefiks URL-a provjeren za aplikaciju, kao i sam videozapis.
Što znače oznake marke?
Obavijesti koje TikTok prikazuje na objavi. is_brand_organic postavljen na true označava je oznakom »Promotional content«, za objave koje promoviraju vlastito poslovanje računa. is_branded_content postavljen na true označava je oznakom »Paid partnership«, za objave nastale u plaćenom partnerstvu s markom, i ima prednost kad su oba true. Kod videozapisa s is_branded_content, tto_invite_link može povezati objavu s kampanjom TikTok One Creator Marketplace kojoj se račun pridružio.
Koje se druge opcije nalaze u post_info?
Još nekoliko, svaka dokumentirana na endpointu koji je prima:
is_ai_generated, videozapisi: objavu označava oznakom »Creator labeled as AI-generated«, što se nakon objave ne može promijeniti.location_iduzlocation_name: oznaka lokacije pronađena putem GET /business/publish/location/.music_sound_info: komercijalni zvuk prema ID-u; kod videozapisa i glasnoća, od 0 do 100, te početak i kraj u milisekundama.auto_add_music, objave fotografija: dodaje preporučenu glazbu, koju se kasnije može promijeniti u aplikaciji TikTok.upload_to_draftiliis_draft: šalje objavu u inbox kreatora kao nacrt, uz videozapis, s opsegom video.upload.is_ads_only, videozapisi: objavljuje objavu »Only show in ads« koja ostaje izvan profila.
Koje postavke postavlja publish_tiktok_post?
Tri dolaze iz vašeg zahtjeva: tekst objave, naslov objave fotografija i disable_comment. easyCoexistence šalje is_brand_organic i is_branded_content kao false, objave fotografija objavljuje kao PUBLIC_TO_EVERYONE s prvom slikom kao naslovnicom i izostavlja ostale postavke videozapisa, pa vrijede TikTokove zadane vrijednosti: disable_duet i disable_stitch su false, thumbnail_offset je 0, a is_ai_generated je false.
Kako šaljete ostale postavke?
Iz vlastitog koda, s tokenom i business_id računa iz get_social_credentials, na putanjama Business API-ja pod business/. GET na business/video/settings/ čita ograničenja računa. POST na business/video/publish/ ili business/photo/publish/ može nositi cijelo dokumentirano tijelo i dolazi do TikToka kako je napisano, uključujući URL-ove medija, pa moraju biti na domeni ili prefiksu URL-a provjerenom za aplikaciju; publish_tiktok_post je poziv koji vašu poveznicu usmjerava kroz provjerenu medijsku rutu usluge easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Uobičajene pogreške
- Očekivanje da privacy_level radi na videozapisu. Endpoint za videozapise objavljuje javne objave, a njegova referenca ne navodi polje za privatnost; objave fotografija primaju privacy_level.
- Uključivanje komentara za račun koji ih ne prima. Kad je comment_disabled true, TikTok prihvaća disable_comment samo kao true.
- Postavljanje thumbnail_offset iza kraja videozapisa. TikTok šalje webhook o neuspjehu i videozapis se ne objavljuje.
- Slanje PUBLIC_TO_EVERYONE za privatni račun. Njegov privacy_level_options umjesto toga navodi FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.
Često postavljana pitanja
Mogu li objaviti privatni TikTok videozapis putem API-ja?
Ne s endpointom za videozapise, koji objavljuje javne objave. Objave fotografija primaju privacy_level, uključujući SELF_ONLY, a videozapis može ići u inbox kreatora kao nacrt uz upload_to_draft.
Kako isključiti Duet i Stitch putem API-ja?
Postavite post_info.disable_duet i post_info.disable_stitch na true na /business/video/publish/. Kad ih račun već ograničava, TikTok prihvaća samo true.
Mogu li dodati oznaku lokacije putem TikTok API-ja?
Da. post_info prima location_id uz location_name, za oznaku lokacije pronađenu putem GET /business/publish/location/.
Koja je razlika između is_brand_organic i is_branded_content?
is_brand_organic dodaje oznaku »Promotional content« za vlastito poslovanje računa; is_branded_content dodaje oznaku »Paid partnership« i ima prednost kad su oba true.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na