API ile TikTok gönderi ayarları: gizlilik, yorumlar, Duet ve Stitch
TikTok'un İşletme API'si, gönderinin ayarlarını yayın çağrısında alır; çoğu post_info içindedir. Videolar disable_comment, disable_duet ve disable_stitch alır; kapağı thumbnail_offset ya da custom_thumbnail_url ile seçer; is_brand_organic ve is_branded_content etiketlerini ve is_ai_generated alanını kullanır. Fotoğraf gönderileri privacy_level, disable_comment, aynı marka etiketlerini ve auto_add_music alır. GET /business/video/settings/ her hesabın izin verdiği değerleri döndürür.
easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan publish_tiktok_post ile TikTok videolarını ve fotoğraf gönderilerini yayımlar; açıklama, fotoğraf gönderisinin başlığı ve yorumların açık ya da kapalı olmasıyla birlikte.
Herkese açık bir hesabın fotoğraf gönderileri için gizlilik seçenekleri: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS ve SELF_ONLY.
Özel bir hesabın PUBLIC_TO_EVERYONE yerine aldığı gizlilik düzeyi: yalnızca takipçilerine görünür.
disable_comment, disable_duet ve disable_stitch varsayılanı: ayarlanmadıkça yorumlar, Duet'ler ve Stitch'ler açık kalır.
Bir video için en büyük özel kapak görseli: en az 360 x 360 piksel, en fazla 20 MB.
is_branded_content etiketi uygulanır; is_brand_organic de true ise bu etiket öncelikli olur.
Fotoğraf gönderisinin post_info alanı için zorunlu alan; GET /business/video/settings/ hesap için döndürdüğü seçeneklerle sınırlıdır.
Her yayın uç noktası hangi ayarları alır?
/business/video/publish/ ve /business/photo/publish/ bazı ayarları paylaşır, bazılarında farklılaşır. Çoğu post_info içindedir; custom_thumbnail_url ve photo_cover_index ise gövdenin en üst düzeyinde durur. TikTok'un referanslarında listelendiği gibi yan yana; bir uç noktanın bir ayar için hiçbir alan belgelemediği yerde Alan yok yazar:
| 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 |
Hesap neye izin verir?
business_id ile GET /business/video/settings/ hesabın gönderilerine ilişkin sınırlarını döndürür. Yayımlamadan önce okuyun, çünkü TikTok yalnızca listelediği değerleri kabul eder:
privacy_level_options: herkese açık bir hesap içinPUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSveSELF_ONLY; özel bir hesap içinFOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSveSELF_ONLY.comment_disabled: hesap hiç kimseden yorum kabul etmiyorsa true olur; bu durumdadisable_commentyalnızca true değerini kabul eder.duet_disabledvestitch_disabled: hesap Duet'e ya da Stitch'e yalnızca 'Yalnızca siz' seçeneğiyle izin veriyorsa ya da hesap özelse true olur; ilgili anahtar yalnızca true değerini kabul eder.max_video_post_duration_sec: hesabın yayımlayabileceği en uzun video; daha uzunu başarısız olur.
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
}
}Gönderiyi kim görebilir?
Fotoğraf gönderisinde gönderdiğiniz privacy_level: TikTok'ta olsun ya da olmasın herkes için PUBLIC_TO_EVERYONE, hesabın geri takip ettiği takipçiler için MUTUAL_FOLLOW_FRIENDS, özel bir hesabın takipçileri için FOLLOWER_OF_CREATOR ya da SELF_ONLY. Video uç noktasında gizlilik alanı yoktur, çünkü herkese açık video gönderileri yayımlar. Arkadaşlara ya da Yalnızca siz olarak ayarlanmış bir gönderi, embed_url üzerinden de izlenemez.
Yorumlar, Duet ve Stitch nasıl çalışır?
Her biri true olarak ayarlandığında özelliği kapatan bir anahtardır. disable_comment iki uç noktada da bulunur; disable_duet ve disable_stitch yalnızca videolarda bulunur. Hepsinin varsayılanı false'tur; bu da özelliği açık bırakır, ancak hesabın kendi gizlilik ayarlarının izin verdiği ölçüde geçerlidir: hiç kimseden yorum kabul etmeyen ya da Duet'i veya Stitch'i yalnızca 'Yalnızca siz' ile sınırlayan bir hesap, anahtarı true olarak ayarlayarak yalnızca yayımlayabilir.
Kapak nasıl seçilir?
Bir videoda iki yol vardır. post_info.thumbnail_offset, milisaniye cinsinden zamana göre bir kare seçer; varsayılanı 0'dır ve en yakın kareye yuvarlanır. Videonun bitişinden sonraki bir zaman başarısızlık webhook'u gönderir ve video yayımlanmaz. Gövdenin en üst düzeyindeki custom_thumbnail_url ise bunun yerine bir görsel verir ve TikTok'un offset değerini yok saymasına neden olur. Fotoğraf gönderisinde photo_cover_index, 0'dan başlayarak görsellerden birini seçer.
- Özel kapak görseli: JPG, JPEG, WebP veya PNG, en fazla 20 MB.
- Boyut: 360 x 360 pikselden 1080 x 1920'ye ya da 1920 x 1080'e kadar.
- Konum: videonun kendisi gibi, uygulama için doğrulanmış bir alan adı ya da URL öneki.
Marka etiketleri ne anlama gelir?
TikTok'un gönderide gösterdiği bildirimler. is_brand_organic true olarak ayarlandığında, hesabın kendi işletmesini tanıtan gönderiler için Ticari içerik etiketi alır. is_branded_content true olarak ayarlandığında, bir markayla ücretli iş birliği içinde yapılan gönderiler için Ücretli iş birliği etiketi alır; ikisi de true ise öncelikli olur. is_branded_content içeren bir videoda tto_invite_link, gönderiyi hesabın katıldığı bir TikTok One Creator Marketplace kampanyasına bağlayabilir.
post_info içinde hangi diğer seçenekler bulunur?
Birkaç tane daha; her biri onu kabul eden uç noktada belgelenmiştir:
is_ai_generated, videolar: gönderiyi yaratıcı tarafından yapay zekâ ile üretildi olarak etiketler; gönderildikten sonra değiştirilemez.location_nameile birliktelocation_id: GET /business/publish/location/ üzerinden bulunan bir konum etiketi.music_sound_info: kimliğiyle bir ticari ses; videolarda ayrıca ses seviyesi (0 ile 100 arası) ve milisaniye cinsinden başlangıç ve bitiş.auto_add_music, fotoğraf gönderileri: önerilen müziği ekler; bu müzik daha sonra TikTok uygulamasında değiştirilebilir.upload_to_draftya dais_draft: gönderiyi video.upload kapsamıyla, videoyla birlikte yaratıcının gelen kutusuna taslak olarak gönderir.is_ads_only, videolar: profilde kalmayan, yalnızca reklamlarda gösterilen bir gönderi yayımlar.
publish_tiktok_post hangi ayarları belirler?
Üçü isteğinizden gelir: açıklama, fotoğraf gönderisinin başlığı ve disable_comment. easyCoexistence is_brand_organic ve is_branded_content değerlerini false olarak gönderir, fotoğraf gönderilerini ilk görseli kapak olarak kullanarak PUBLIC_TO_EVERYONE ile yayımlar ve bir videonun geri kalan ayarlarını dışarıda bırakır; böylece TikTok'un varsayılanları geçerli olur: disable_duet ve disable_stitch false, thumbnail_offset 0 ve is_ai_generated false.
Diğer ayarları nasıl gönderirsiniz?
Kendi kodunuzdan, get_social_credentials'tan aldığınız hesabın token ve business_id değerleriyle, business/ altındaki Business API yollarında. business/video/settings/ adresine yapılan bir GET, hesabın sınırlarını okur. business/video/publish/ ya da business/photo/publish/ adresine yapılan bir POST, belgelenmiş tam gövdeyi taşıyabilir ve medya URL'leri dahil olmak üzere olduğu gibi TikTok'a ulaşır; bu yüzden uygulama için doğrulanmış bir alan adı ya da URL öneki üzerinde bulunmalıdırlar. publish_tiktok_post ise bağlantınızı easyCoexistence'ın doğrulanmış medya rotası üzerinden yönlendiren çağrıdır.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Yaygın hatalar
- Bir videoda privacy_level'ın çalışmasını beklemek. Video uç noktası herkese açık gönderiler yayımlar ve belgesinde gizlilik alanı yoktur; fotoğraf gönderileri privacy_level alır.
- Hiç yorum almayan bir hesap için yorumları açmak. comment_disabled true olduğunda TikTok disable_comment'i yalnızca true olarak kabul eder.
- thumbnail_offset değerini videonun bitişinden sonraya ayarlamak. TikTok başarısızlık webhook'u gönderir ve video yayımlanmaz.
- Özel bir hesap için PUBLIC_TO_EVERYONE göndermek. Onun privacy_level_options listesi bunun yerine FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS ve SELF_ONLY'yi içerir.
Hesabın izin verilen ayarlarını okumak için token'ı ise get_social_credentials kendi kodunuza verir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı ekledikçe düşer, ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
API üzerinden özel bir TikTok videosu paylaşabilir miyim?
Herkese açık gönderiler yayımlayan video uç noktasıyla mümkün değil. Fotoğraf gönderileri privacy_level alır; SELF_ONLY da buna dahil. Bir video ise upload_to_draft ile yaratıcının gelen kutusuna taslak olarak gönderilebilir.
API üzerinden Duet'leri ve Stitch'leri nasıl kapatabilirim?
/business/video/publish/ üzerinde post_info.disable_duet ve post_info.disable_stitch değerlerini true olarak ayarlayın. Hesap bunları zaten sınırlıyorsa TikTok yalnızca true değerini kabul eder.
TikTok API ile konum etiketi ekleyebilir miyim?
Evet. post_info, GET /business/publish/location/ üzerinden bulunan bir konum etiketi için location_name ile birlikte location_id alır.
is_brand_organic ile is_branded_content arasındaki fark nedir?
is_brand_organic, hesabın kendi işletmesi için bir Ticari içerik etiketi ekler; is_branded_content ise bir Ücretli iş birliği etiketi ekler ve ikisi de true olduğunda öncelikli olur.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi