TikTok podešavanja objava preko API-ja: privatnost, komentari, Duet i Stitch
TikTokov API for Business prima podešavanja objave u pozivu za objavljivanje, uglavnom unutar post_info. Video objave primaju disable_comment, disable_duet i disable_stitch, naslovnu sliku preko thumbnail_offset ili custom_thumbnail_url, oznake is_brand_organic i is_branded_content i is_ai_generated. Objave sa fotografijama primaju privacy_level, disable_comment, iste oznake brenda i auto_add_music. GET /business/video/settings/ vraća vrednosti koje svaki nalog dozvoljava.
easyCoexistence objavljuje TikTok videe i objave sa fotografijama pomoću publish_tiktok_post iz Claude-a, ChatGPT-a ili sopstvenog koda, sa opisom, naslovom objave sa fotografijama i komentarima uključenim ili isključenim, a get_social_credentials daje vašem kodu token za čitanje dozvoljenih podešavanja naloga.
Opcije privatnosti za objave fotografija javnog naloga: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
Nivo privatnosti koji privatni nalog dobija umesto PUBLIC_TO_EVERYONE: vidljivo samo njegovim pratiocima.
Podrazumevana vrednost za disable_comment, disable_duet i disable_stitch, pa komentari, Duet i Stitch ostaju uključeni dok se ne podese.
Najveća prilagođena naslovna slika za video, koja mora imati najmanje 360 x 360 piksela i najviše 20 MB.
Oznaka is_branded_content se dodaje i ima prednost kada je is_brand_organic takođe true.
Obavezno polje post_info objave sa fotografijama, ograničeno na opcije koje GET /business/video/settings/ vraća za nalog.
Koja podešavanja prima svaki endpoint za objavljivanje?
/business/video/publish/ i /business/photo/publish/ dele neka podešavanja, a razlikuju se u drugima. Većina se nalazi unutar post_info, dok se custom_thumbnail_url i photo_cover_index nalaze na najvišem nivou tela zahteva. Uporedo, onako kako ih navode TikTokove reference, uz „nema polja“ tamo gde endpoint za to podešavanje ništa ne dokumentuje:
| 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 |
Šta nalog dozvoljava?
GET /business/video/settings/ sa business_id vraća ograničenja naloga za njegove objave. Pročitajte ga pre objavljivanja, jer TikTok prihvata samo vrednosti koje navodi:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSiSELF_ONLYza javni nalog;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSiSELF_ONLYza privatni.comment_disabled: true kada nalog ne prima komentare ni od koga, i tadadisable_commentprihvata samo true.duet_disabledistitch_disabled: true kada nalog dozvoljava Duet ili Stitch samo od Only you ili je privatan; odgovarajući prekidač tada prihvata samo true.max_video_post_duration_sec: najduži video koji nalog može da objavi; duži ne uspeva.
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
}
}Ko može da vidi objavu?
Na objavi sa fotografijama, privacy_level koji pošaljete: PUBLIC_TO_EVERYONE za ljude na TikToku i van njega, MUTUAL_FOLLOW_FRIENDS za pratioce koje nalog takođe prati, FOLLOWER_OF_CREATOR za pratioce privatnog naloga, ili SELF_ONLY. Endpoint za video nema polje privacy, jer objavljuje javne video objave. Objava podešena na Friends ili Only you ne može se gledati ni preko embed_url.
Kako rade komentari, Duet i Stitch?
Svaki je prekidač koji isključuje funkciju kada se postavi na true. disable_comment postoji na oba endpointa; disable_duet i disable_stitch postoje samo na videu. Svi su podrazumevano false, što funkciju ostavlja uključenom, u okviru onoga što dozvoljavaju sopstvena podešavanja privatnosti naloga: nalog koji ne prima komentare od nikoga, ili koji ograničava Duet ili Stitch na Only you, može objaviti samo uz taj prekidač postavljen na true.
Kako se bira naslovna slika?
Kod videa, na dva načina. post_info.thumbnail_offset bira kadar po vremenu u milisekundama, podrazumevano 0, zaokruženo na najbliži kadar; vreme posle kraja videa šalje webhook sa greškom i video se ne objavljuje. custom_thumbnail_url, na najvišem nivou tela zahteva, umesto toga daje sliku i tera TikTok da ignoriše offset. Kod objave sa fotografijama, photo_cover_index bira jednu od slika, brojeći od 0.
- Prilagođena naslovna slika: JPG, JPEG, WebP ili PNG, do 20 MB.
- Veličina: od 360 x 360 piksela do 1080 x 1920, ili 1920 x 1080.
- Lokacija: domen ili prefiks URL-a verifikovan za aplikaciju, kao i sam video.
Šta znače oznake brenda?
Obaveštenja koja TikTok prikazuje na objavi. is_brand_organic postavljen na true označava je kao Promotional content, za objave koje promovišu posao samog naloga. is_branded_content postavljen na true označava je kao Paid partnership, za objave napravljene u plaćenom partnerstvu sa brendom, i ima prednost kada su oba true. Kod videa sa is_branded_content, tto_invite_link može da poveže objavu sa kampanjom TikTok One Creator Marketplace u kojoj nalog učestvuje.
Koje druge opcije stoje u post_info?
Još nekoliko, a svaku dokumentuje endpoint koji je prihvata:
is_ai_generated, za videe: označava objavu kao „Creator labeled as AI-generated“, što se ne može promeniti kada je objavljena.location_iduzlocation_name: oznaka lokacije pronađena preko GET /business/publish/location/.music_sound_info: komercijalni zvuk po ID-ju; kod videa i njegova jačina, od 0 do 100, te početak i kraj u milisekundama.auto_add_music, objave sa fotografijama: dodaje preporučenu muziku, koju je kasnije moguće promeniti u TikTok aplikaciji.upload_to_draftiliis_draft: šalje objavu u inbox kreatora kao nacrt, uz video.upload scope.is_ads_only, za videe: objavljuje objavu „Only show in ads“ koja ostaje van profila.
Koja podešavanja postavlja publish_tiktok_post?
Tri dolaze iz vašeg zahteva: opis objave, naslov objave sa fotografijama i disable_comment. easyCoexistence šalje is_brand_organic i is_branded_content kao false, objavljuje objave sa fotografijama kao PUBLIC_TO_EVERYONE sa prvom slikom kao naslovnom, i izostavlja ostala podešavanja videa, pa se primenjuju TikTokovi podrazumevani: disable_duet i disable_stitch false, thumbnail_offset 0 i is_ai_generated false.
Kako šaljete ostala podešavanja?
Iz vašeg sopstvenog koda, sa tokenom i business_id naloga iz get_social_credentials, na putanjama Business API-ja pod business/. GET ka business/video/settings/ čita ograničenja naloga. POST na business/video/publish/ ili business/photo/publish/ može da nosi celo dokumentovano telo, i stiže do TikToka onako kako je napisano, uključujući URL-ove medija, pa oni moraju biti na domenu ili prefiksu URL-a verifikovanom za aplikaciju. publish_tiktok_post je poziv koji vaš link šalje preko verifikovane medijske rute easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Česte greške
- Očekivanje da privacy_level radi na videu. Endpoint za video objavljuje javne objave i njegova referenca nema polje privacy; objave sa fotografijama primaju privacy_level.
- Uključivanje komentara za nalog koji ih ne prima. Kada je comment_disabled true, TikTok prihvata disable_comment samo kao true.
- Postavljanje thumbnail_offset posle kraja videa. TikTok šalje webhook sa greškom i video se ne objavljuje.
- Slanje PUBLIC_TO_EVERYONE za privatni nalog. Njegov privacy_level_options umesto toga navodi FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
Od US$ 9 do US$ 0.75 po vezi mesečno, sa padom kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Mogu li preko API-ja da objavim privatni TikTok video?
Ne sa endpointom za video, koji objavljuje javne objave. Objave sa fotografijama primaju privacy_level, uključujući SELF_ONLY, a video može da ode u inbox kreatora kao nacrt uz upload_to_draft.
Kako isključim Duet i Stitch preko API-ja?
Postavite post_info.disable_duet i post_info.disable_stitch na true na /business/video/publish/. Kada nalog već ograničava ta podešavanja, TikTok prihvata samo true.
Mogu li da dodam oznaku lokacije preko TikTok API-ja?
Mogu. post_info prihvata location_id uz location_name, za oznaku lokacije pronađenu preko GET /business/publish/location/.
Koja je razlika između is_brand_organic i is_branded_content?
is_brand_organic dodaje oznaku Promotional content za posao samog naloga; is_branded_content dodaje oznaku Paid partnership i ima prednost kada su oba true.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na