Definições de publicação no TikTok através da API: privacidade, comentários, Duet e Stitch
A API for Business do TikTok recebe as definições de uma publicação na chamada de publicação, sobretudo dentro de post_info. Os vídeos recebem disable_comment, disable_duet e disable_stitch, uma capa a partir de thumbnail_offset ou custom_thumbnail_url, e os rótulos is_brand_organic, is_branded_content e is_ai_generated. As publicações de fotografia recebem privacy_level, disable_comment, os mesmos rótulos de marca e auto_add_music. GET /business/video/settings/ devolve os valores permitidos a cada conta.
A easyCoexistence publica vídeos e publicações de fotografia no TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código, com a legenda, o título de uma publicação de fotografia e os comentários ativados ou desativados, e get_social_credentials dá ao seu próprio código o token para ler os valores permitidos de uma conta.
Opções de privacidade para as publicações de fotografia de uma conta pública: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.
Nível de privacidade que uma conta privada recebe em vez de PUBLIC_TO_EVERYONE: visível apenas para os seus seguidores.
Predefinição de disable_comment, disable_duet e disable_stitch, pelo que os comentários, Duets e Stitches ficam ativos, salvo definição em contrário.
Maior imagem de capa personalizada para um vídeo, que deve ter pelo menos 360 x 360 píxeis e até 20 MB.
O rótulo que is_branded_content aplica prevalece quando is_brand_organic também é true.
Campo obrigatório de post_info numa publicação de fotografia, limitado às opções que GET /business/video/settings/ devolve para a conta.
Que definições aceita cada endpoint de publicação?
/business/video/publish/ e /business/photo/publish/ partilham algumas definições e diferem noutras. A maioria está dentro de post_info, enquanto custom_thumbnail_url e photo_cover_index estão ao nível superior do corpo. Lado a lado, tal como as referências do TikTok as listam, com Sem campo onde um endpoint não documenta nada para essa definição:
| 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 |
O que permite a conta?
GET /business/video/settings/ com business_id devolve os limites da conta para as suas publicações. Leia-o antes de publicar, uma vez que o TikTok aceita apenas os valores que lista:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSeSELF_ONLYpara uma conta pública;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSeSELF_ONLYpara uma conta privada.comment_disabled: true quando a conta não aceita comentários de ninguém, e nesse casodisable_commentaceita apenas true.duet_disabledestitch_disabled: true quando a conta permite Duet ou Stitch apenas para 'Só eu', ou é privada; o interruptor correspondente aceita então apenas true.max_video_post_duration_sec: o vídeo mais longo que a conta pode publicar; um vídeo mais longo falha.
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
}
}Quem pode ver a publicação?
Numa publicação de fotografia, o privacy_level que envia: PUBLIC_TO_EVERYONE para pessoas dentro ou fora do TikTok, MUTUAL_FOLLOW_FRIENDS para os seguidores que a conta também segue, FOLLOWER_OF_CREATOR para os seguidores de uma conta privada, ou SELF_ONLY. O endpoint de vídeo não tem campo de privacidade, uma vez que publica vídeos públicos. Uma publicação definida como Amigos ou Só eu também não pode ser vista através do seu embed_url.
Como funcionam os comentários, Duet e Stitch?
Cada um é um interruptor que desativa a funcionalidade quando definido como true. disable_comment existe nos dois endpoints; disable_duet e disable_stitch existem apenas em vídeos. Todos têm por predefinição false, o que mantém a funcionalidade ativa dentro do que as definições de privacidade da própria conta permitem: uma conta que não aceita comentários de ninguém, ou que limita Duet ou Stitch a Só eu, só pode publicar com esse interruptor definido como true.
Como se escolhe a capa?
Num vídeo, de duas formas. post_info.thumbnail_offset escolhe um fotograma pelo seu tempo em milissegundos, 0 por predefinição, arredondado para o fotograma mais próximo; um tempo além do fim do vídeo envia um webhook de falha e o vídeo não é publicado. custom_thumbnail_url, ao nível superior do corpo, indica uma imagem em vez disso e faz o TikTok ignorar o offset. Numa publicação de fotografia, photo_cover_index escolhe uma das imagens, começando em 0.
- Imagem de capa personalizada: JPG, JPEG, WebP ou PNG, até 20 MB.
- Dimensões: de 360 x 360 píxeis até 1080 x 1920, ou 1920 x 1080.
- Localização: um domínio ou prefixo de URL verificado para a aplicação, tal como o próprio vídeo.
O que significam os rótulos de marca?
São divulgações que o TikTok mostra na publicação. is_brand_organic definido como true rotula-a como Conteúdo promocional, para publicações que promovem o negócio da própria conta. is_branded_content definido como true rotula-a como Parceria paga, para publicações feitas numa parceria paga com uma marca, e tem precedência quando ambos são true. Num vídeo com is_branded_content, tto_invite_link pode ligar a publicação a uma campanha do TikTok One Creator Marketplace em que a conta esteja inscrita.
Que outras opções existem em post_info?
Mais algumas, cada uma documentada no endpoint que a recebe:
is_ai_generated, vídeos: rotula a publicação como Identificado pelo criador como gerado por IA, o que não pode ser alterado depois de publicada.location_idcomlocation_name: uma etiqueta de localização encontrada através de GET /business/publish/location/.music_sound_info: um som comercial pelo ID; nos vídeos também o seu volume, de 0 a 100, e o seu início e fim em milissegundos.auto_add_music, publicações de fotografia: adiciona música recomendada, que pode ser alterada mais tarde na aplicação do TikTok.upload_to_draftouis_draft: envia a publicação para a caixa de entrada do criador como rascunho, com o vídeo, com o âmbito video.upload.is_ads_only, vídeos: publica uma publicação Só mostrar em anúncios que fica fora do perfil.
Que definições define o publish_tiktok_post?
Três vêm do seu pedido: a legenda, o título de uma publicação de fotografia e disable_comment. A easyCoexistence envia is_brand_organic e is_branded_content como false, publica as publicações de fotografia como PUBLIC_TO_EVERYONE com a primeira imagem como capa, e deixa de fora o resto das definições de um vídeo, pelo que se aplicam as predefinições do TikTok: disable_duet e disable_stitch como false, thumbnail_offset 0 e is_ai_generated como false.
Como enviar as outras definições?
A partir do seu próprio código, com o token e o business_id da conta de get_social_credentials, em caminhos da API for Business sob business/. Um GET para business/video/settings/ lê os limites da conta. Um POST para business/video/publish/ ou business/photo/publish/ pode levar o corpo documentado completo, e chega ao TikTok tal como escrito, incluindo os URLs dos ficheiros multimédia, pelo que têm de estar num domínio ou prefixo de URL verificado para a aplicação; publish_tiktok_post é a chamada que encaminha o seu link pela rota de multimédia verificada da easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Erros comuns
- Esperar que privacy_level funcione num vídeo. O endpoint de vídeo publica publicações públicas e a sua referência não lista nenhum campo de privacidade; as publicações de fotografia aceitam privacy_level.
- Ativar comentários numa conta que não aceita nenhum. Quando comment_disabled é true, o TikTok aceita disable_comment apenas como true.
- Definir thumbnail_offset além do fim do vídeo. O TikTok envia um webhook de falha e o vídeo não é publicado.
- Enviar PUBLIC_TO_EVERYONE para uma conta privada. A sua privacy_level_options lista, em vez disso, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.
De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Posso publicar um vídeo privado do TikTok através da API?
Não com o endpoint de vídeo, que publica publicações públicas. As publicações de fotografia aceitam privacy_level, incluindo SELF_ONLY, e um vídeo pode ir para a caixa de entrada do criador como rascunho com upload_to_draft.
Como desligo os Duets e os Stitches através da API?
Defina post_info.disable_duet e post_info.disable_stitch como true em /business/video/publish/. Quando a conta já os limita, o TikTok aceita apenas true.
Posso adicionar uma etiqueta de localização através da API do TikTok?
Sim. post_info aceita location_id com location_name, para uma etiqueta de localização encontrada através de GET /business/publish/location/.
Qual é a diferença entre is_brand_organic e is_branded_content?
is_brand_organic acrescenta o rótulo Conteúdo promocional para o negócio da própria conta; is_branded_content acrescenta o rótulo Parceria paga e prevalece quando ambos são true.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em