Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

TikTokin API:n julkaisuasetukset: näkyvyys, kommentit, Duet ja Stitch

TikTokin API for Business ottaa postauksen asetukset vastaan julkaisukutsussa, pääosin post_info-kentän sisällä. Videot ottavat disable_comment-, disable_duet- ja disable_stitch-asetukset, kansikuvan thumbnail_offset- tai custom_thumbnail_url-kentästä, is_brand_organic- ja is_branded_content-merkinnät sekä is_ai_generated-merkinnän. Kuvapostaukset ottavat privacy_level-, disable_comment- ja samat brändimerkinnät sekä auto_add_music-asetuksen. GET /business/video/settings/ palauttaa arvot, jotka kukin tili sallii.

easyCoexistence julkaisee TikTok-videoita ja kuvapostauksia publish_tiktok_post-kutsulla Claudesta, ChatGPT:stä tai omasta koodistasi, kuvatekstin, kuvapostauksen otsikon ja kommentit päälle tai pois kytkettynä, ja get_social_credentials antaa omalle koodillesi tokenin tilin sallittujen asetusten lukemiseen.

3 levels

Kuvapostausten näkyvyysvaihtoehdot julkisella tilillä: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS ja SELF_ONLY.

FOLLOWER_OF_CREATOR

Yksityinen tili saa PUBLIC_TO_EVERYONE-arvon sijaan näkyvyystason, jossa postaus näkyy vain sen seuraajille.

false

Oletusarvo disable_comment-, disable_duet- ja disable_stitch-asetuksille on false, joten kommentit, Duetit ja Stitchit pysyvät päällä, ellei niitä aseta toisin.

1080 x 1920

Videon mukautetun kansikuvan suurin koko, joka on vähintään 360 x 360 pikseliä ja enintään 20 Mt.

Paid partnership

is_branded_content-merkintä, joka lisätään, voittaa, kun is_brand_organic on myös true.

privacy_level

Kuvapostauksen post_info-kentän pakollinen kenttä, rajattuna niihin vaihtoehtoihin, joita GET /business/video/settings/ palauttaa tilille.

Mitä asetuksia kukin julkaisu-endpoint ottaa vastaan?

/business/video/publish/ ja /business/photo/publish/ jakavat osan asetuksista ja eroavat toisista. Useimmat ovat post_info-kentän sisällä, kun taas custom_thumbnail_url ja photo_cover_index ovat kutsun rungon ylimmällä tasolla. Rinnakkain, niin kuin TikTokin viitteissä ne on lueteltu. Merkintä No field tarkoittaa, että endpoint ei dokumentoi kyseistä asetusta:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Mitä tili sallii?

GET /business/video/settings/ business_id-parametrilla palauttaa tilin rajat sen postauksille. Lue se ennen julkaisua, sillä TikTok hyväksyy vain ne arvot, jotka se listaa:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS ja SELF_ONLY julkiselle tilille; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS ja SELF_ONLY yksityiselle.
  • comment_disabled: true, kun tili ei ota kommentteja keneltäkään. Silloin disable_comment hyväksyy vain arvon true.
  • duet_disabled ja stitch_disabled: true, kun tili sallii Duetit tai Stitchit vain asetuksella Vain sinä tai on yksityinen. Vastaava kytkin hyväksyy silloin vain arvon true.
  • max_video_post_duration_sec: pisin video, jonka tili voi julkaista; pidempi epäonnistuu.
Read an account's post settings
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
  }
}

Kuka näkee postauksen?

Kuvapostauksessa lähettämäsi privacy_level: PUBLIC_TO_EVERYONE kaikille TikTokissa tai sen ulkopuolella oleville, MUTUAL_FOLLOW_FRIENDS seuraajille, joita tili seuraa takaisin, FOLLOWER_OF_CREATOR yksityisen tilin seuraajille tai SELF_ONLY. Videoendpointissa ei ole privacy-kenttää, koska se julkaisee julkisia videopostauksia. Postausta, joka on asetettu tilaan Ystävät tai Vain sinä, ei voi katsoa myöskään sen embed_url-osoitteen kautta.

Miten kommentit, Duet ja Stitch toimivat?

Jokainen on kytkin, joka kytkee ominaisuuden pois, kun se asetetaan arvoon true. disable_comment on molemmissa endpointeissa, kun taas disable_duet ja disable_stitch ovat vain videoissa. Kaikki ovat oletuksena false, jolloin ominaisuus pysyy päällä tilin omien yksityisyysasetusten sallimissa rajoissa. Tili, joka ei ota kommentteja keneltäkään tai rajoittaa Duetit ja Stitchit vain sinulle, voi julkaista vain, kun kytkin on asetettu arvoon true.

Miten kansikuva valitaan?

Videossa on kaksi tapaa. post_info.thumbnail_offset valitsee kuvan ajan perusteella millisekunteina, oletuksena 0, pyöristettynä ylöspäin lähimpään kuvaruutuun. Aika videon lopun jälkeen lähettää virheilmoituksen webhookin kautta, eikä videoa julkaista. custom_thumbnail_url kutsun rungon ylimmällä tasolla antaa sen sijaan kuvan ja saa TikTokin ohittamaan offsetin. Kuvapostauksessa photo_cover_index valitsee yhden kuvista laskien nollasta alkaen.

  • Mukautettu kansikuva: JPG, JPEG, WebP tai PNG, enintään 20 Mt.
  • Koko: vähintään 360 x 360 pikseliä, enintään 1080 x 1920 tai 1920 x 1080.
  • Sijainti: verkkotunnus tai URL-etuliite, joka on vahvistettu sovellukselle, kuten itse videokin.

Mitä brändimerkinnät tarkoittavat?

Merkinnät, joita TikTok näyttää postauksessa. is_brand_organic asetettuna arvoon true merkitsee postauksen Mainossisällöksi, eli postauksiksi, jotka mainostavat tilin omaa yritystä. is_branded_content asetettuna arvoon true merkitsee postauksen Maksettu yhteistyö -merkinnällä, kun se on tehty maksetussa yhteistyössä brändin kanssa, ja se menee edelle, kun molemmat ovat true. Videossa, jossa on is_branded_content, tto_invite_link voi yhdistää postauksen TikTok One Creator Marketplace -kampanjaan, johon tili on liittynyt.

Mitkä muut vaihtoehdot ovat post_info-kentässä?

Muutama lisää, kukin dokumentoituna endpointissa, joka sen ottaa:

  • is_ai_generated, videot: merkitsee postauksen tekijän ilmoittamaksi tekoälyn tuottamaksi, eikä merkintää voi muuttaa julkaisun jälkeen.
  • location_id ja location_name: sijaintimerkintä, joka löytyy GET /business/publish/location/ -endpointista.
  • music_sound_info: kaupallinen ääni ID:n perusteella; videoissa myös sen voimakkuus, 0–100, sekä alku- ja loppuaika millisekunteina.
  • auto_add_music, kuvapostaukset: lisää suositeltua musiikkia, jota voi vaihtaa myöhemmin TikTok-sovelluksessa.
  • upload_to_draft tai is_draft: lähettää postauksen tekijän saapuneisiin luonnoksena videon kanssa video.upload-oikeuksilla.
  • is_ads_only, videot: julkaisee postauksen Näytetään vain mainoksissa, joka pysyy pois profiilista.

Mitä asetuksia publish_tiktok_post asettaa?

Kolme tulee pyynnöstäsi: kuvateksti, kuvapostauksen otsikko ja disable_comment. easyCoexistence lähettää is_brand_organic- ja is_branded_content-arvoiksi false, julkaisee kuvapostaukset arvolla PUBLIC_TO_EVERYONE ja ensimmäisen kuvan kansikuvana, ja jättää videon muut asetukset pois, jolloin TikTokin oletukset pätevät: disable_duet ja disable_stitch false, thumbnail_offset 0 ja is_ai_generated false.

Miten muut asetukset lähetetään?

Omasta koodistasi, tilin tokenilla ja business_id-kentällä, jotka saat get_social_credentials-työkalulla, Business API -poluilla polun business/ alla. GET business/video/settings/ lukee tilin rajat. POST business/video/publish/ tai business/photo/publish/ voi sisältää koko dokumentoidun rungon, ja se menee TikTokiin sellaisenaan, myös media-URL:t mukaan lukien. Niiden on siksi oltava verkkotunnuksella tai URL-etuliitteellä, joka on vahvistettu sovellukselle. publish_tiktok_post on kutsu, joka ohjaa linkkisi easyCoexistencen vahvistettuun media-reittiin.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Yleiset virheet

  • Odotetaan, että privacy_level toimii videolla. Videoendpoint julkaisee julkisia postauksia, eikä sen viitteessä ole privacy-kenttää. Kuvapostaukset ottavat privacy_level-asetuksen.
  • Kommenttien kytkeminen päälle tilille, joka ei ota niitä lainkaan. Kun comment_disabled on true, TikTok hyväksyy disable_comment-asetukselle vain arvon true.
  • thumbnail_offsetin asettaminen videon lopun ohi. TikTok lähettää virheilmoituksen webhookin kautta, eikä videoa julkaista.
  • PUBLIC_TO_EVERYONE-arvon lähettäminen yksityiselle tilille. Sen privacy_level_options listaa sen sijaan FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS ja SELF_ONLY.
Näin teet tämän EasyCoexistencen avulla

US$ 9:stä US$ 0,75:een yhteydeltä kuukaudessa, hinta laskee yhteyksiä lisätessä, ensimmäiset 3 päivää ilmaista kokeilua.

Usein kysytyt kysymykset

Voinko julkaista yksityisen TikTok-videon API:n kautta?

Et videoendpointilla, joka julkaisee julkisia postauksia. Kuvapostaukset ottavat privacy_level-asetuksen, myös SELF_ONLY-arvon, ja video voidaan lähettää tekijän saapuneisiin luonnoksena upload_to_draft-kentän avulla.

Miten poistan Duetit ja Stitchit käytöstä API:n kautta?

Aseta post_info.disable_duet ja post_info.disable_stitch arvoon true kohteessa /business/video/publish/. Kun tili rajoittaa niitä jo, TikTok hyväksyy vain arvon true.

Voinko lisätä sijaintimerkinnän TikTok API:n kautta?

Kyllä. post_info ottaa location_id:n ja location_name:n, sijaintimerkinnälle, joka löytyy GET /business/publish/location/ -endpointista.

Mikä ero on kentillä is_brand_organic ja is_branded_content?

is_brand_organic lisää tilin oman yrityksen Mainossisältö-merkinnän. is_branded_content lisää Maksettu yhteistyö -merkinnän ja voittaa, kun molemmat ovat true.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu