这是indexloc提供的服务，不要输入任何密码
API do Threads

Posts do Threads

Você pode usar a API do Threads para publicar posts de imagem, vídeo, texto ou carrossel.

Este documento abrange o seguinte:

Posts individuais do Threads

Para publicar um post com uma imagem, um vídeo ou um texto, siga este processo de duas etapas:

  1. Use o ponto de extremidade POST /{threads-user-id}/threads para criar um contêiner de mídia usando uma imagem ou um vídeo hospedado no seu servidor público e texto opcional. Como alternativa, use esse ponto de extremidade para criar um contêiner de mídia somente com texto.
  2. Use o ponto de extremidade POST /{threads-user-id}/threads_publish para publicar o contêiner.

Limitações

  • Os posts de texto podem ter até 500 caracteres.

Etapa 1: criar um contêiner de mídia do Threads

Use o ponto de extremidade POST /{threads-user-id}/threads para criar um contêiner de mídia do Threads.

Parâmetros

Os parâmetros a seguir são obrigatórios. Consulte a referência do ponto de extremidade POST /{threads-user-id}/threads para ver outros parâmetros compatíveis.

  • is_carousel_item: o valor padrão é false para posts individuais do Threads. Indica uma imagem ou um vídeo que aparecerá em um carrossel.
  • image_url: (apenas para imagens) É o caminho da imagem. Criaremos um cURL para a imagem usando o URL fornecido, que deve estar em um servidor público.
  • media_type: defina como TEXT, IMAGE ou VIDEO. Indica o tipo de mídia atual. Observação: o tipo CAROUSEL não está disponível para posts individuais do Threads.
  • video_url: (somente para vídeos) É o caminho do vídeo. Criaremos um cURL para o vídeo usando o URL fornecido, que deve estar em um servidor público.
  • text: é o texto associado ao post. O primeiro URL incluído no campo text será usado como prévia do link para o post. Para posts somente de texto, esse parâmetro é obrigatório.

Exemplo de solicitação

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=IMAGE&image_url=https://www.example.com/images/bronz-fonz.jpg&text=#BronzFonz&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "1234567" // Threads Media Container ID
}

Etapa 2: publicar um contêiner de mídia do Threads

Use o ponto de extremidade POST /{threads-user-id}/threads_publish para publicar a identificação do contêiner retornada na etapa anterior. É recomendado esperar, em média, 30 segundos antes de publicar um contêiner de mídia do Threads para que nosso servidor consiga processar o carregamento. Para saber mais, consulte o ponto de extremidade de status do contêiner de mídia.

Parâmetros

  • creation_id: é o identificador do contêiner de mídia do Threads criado usando o ponto de extremidade /threads.

Exemplo de solicitação

curl -i -X POST \ 
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish?creation_id=<MEDIA_CONTAINER_ID>&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "1234567" // Threads Media ID
}

Posts em carrossel

Você pode publicar até 20 imagens, vídeos ou uma combinação dos dois em um post em carrossel. O processo de publicação de carrosséis ocorre em três etapas:

  1. Use o ponto de extremidade POST /{threads-user-id}/threads para criar contêineres de itens individuais para cada imagem e vídeo que aparecerão no carrossel.
  2. Use o ponto de extremidade POST /{threads-user-id}/threads novamente para criar um único contêiner de carrossel para os itens.
  3. Use o ponto de extremidade POST /{threads-user-id}/threads_publish para publicar o contêiner do carrossel.

Os posts em carrossel são contabilizados como um post individual em relação ao limite de volume do perfil.

Limitações

  • Os carrosséis podem ter no máximo 20 imagens, vídeos ou uma combinação dos dois.
  • Para criar um carrossel, você precisa ter pelo menos dois itens.

Etapa 1: criar um contêiner de item

Use o ponto de extremidade POST /{threads-user-id}/threads para criar um contêiner de item para a imagem ou o vídeo que aparecerá no carrossel.

Parâmetros

Os parâmetros a seguir são obrigatórios. Consulte a referência do ponto de extremidade POST /{threads-user-id}/threads para ver outros parâmetros compatíveis.

  • is_carousel_item: defina como true. Indica que a imagem ou o vídeo aparecerá em um carrossel.
  • image_url: (apenas para imagens) É o caminho da imagem. Criaremos um cURL para a imagem com base no URL fornecido, que deve estar em um servidor público.
  • media_type: defina como IMAGE ou VIDEO. Indica que a mídia é uma imagem ou um vídeo.
  • video_url: (somente para vídeos) É o caminho do vídeo. Criaremos um cURL para o vídeo com base no URL fornecido, que deve estar em um servidor público.

Observação: embora o campo text seja opcional para posts em carrossel, o primeiro URL incluído no campo text será usado como prévia do link para o post.

Se a operação for bem-sucedida, a API retornará uma identificação do contêiner de item, que poderá ser usada ao criar o contêiner de carrossel.

Repita esse processo para cada imagem ou vídeo que deve aparecer no carrossel.

Exemplo de solicitação

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?image_url=https%3A%2F%2Fsol...&is_carousel_item=true&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "1234567"
}

Etapa 2: criar um contêiner de carrossel

Use o ponto de extremidade POST /{threads-user-id}/threads para criar um contêiner de carrossel.

Parâmetros

Os parâmetros a seguir são obrigatórios. Consulte a referência do ponto de extremidade POST /{threads-user-id}/threads para ver outros parâmetros compatíveis.

  • media_type: defina como CAROUSEL. Indica que o contêiner é destinado a um carrossel.
  • children: é uma lista separada por vírgulas de até 20 identificações de contêiner de cada imagem e/ou vídeo que deve aparecer no carrossel publicado. Os carrosséis podem ter no mínimo 2 e no máximo 20 imagens/vídeos no total ou uma combinação dos dois.
  • text— (opcional) é o texto associado ao post.

Exemplo de solicitação

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=CAROUSEL&children=<MEDIA_ID_1>,<MEDIA_ID_2>,<MEDIA_ID_3>&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "1234567"
}

Etapa 3: publicar o contêiner de carrossel

Use o ponto de extremidade POST /{threads-user-id}/threads_publish para publicar o post em carrossel. Os perfis são limitados a 250 posts publicados em um período de 24 horas. Publicar um carrossel conta como um único post.

Parâmetros

Os parâmetros a seguir são obrigatórios.

  • creation_id: é a identificação do contêiner de carrossel.

Se a operação for bem-sucedida, a API retornará a identificação da mídia do Threads de um álbum de carrossel.

Exemplo de solicitação

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish?creation_id=<MEDIA_CONTAINER_ID>&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "1234567" // Threads Media ID
}

Tags de tópicos e links em posts

Os tópicos e links aparecem em posts como uma forma de incentivar o engajamento.

Tags de tópicos

Os tópicos tornam os posts mais interativos ao permitir temas centrais de discussão. Para incluir um tópico em um post, use o parâmetro topic_tag ou inclua a tag no texto de um post.

Usando o parâmetro topic_tag

Observação: os caracteres a seguir não são permitidos em tags de tópicos:

  • Pontos (.)
  • E comercial (&)
curl -i -X POST \  
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=Text&access_token=<ACCESS_TOKEN>"
  -d topic_tag=TAG

Usando uma tag de tópico no texto

Observação: este não é o método preferencial, mas é mantido para compatibilidade com versões anteriores.

Um tópico também pode ser vinculado a um post ao ser incluído diretamente no texto. Só é possível usar uma tag de tópico por post. Assim, a primeira tag válida incluída via API em um post de qualquer tipo (somente texto, imagem, vídeo, carrossel) será tratada como a tag do post em questão.

Informações importantes para adicionar a tag de tópico ao post usando uma tag no texto:

  • As tags válidas começam com um sinal de cerquilha ou hashtag (#).
  • O texto também é configurado no app sem o sinal de cerquilha.
  • Os números inteiros precedidos por um sinal de hash (ou seja, #1) não serão convertidos em uma tag. Isso ocorre porque se assume que o símbolo "#" está sendo usado como um sinal de número neste cenário.
  • Os caracteres a seguir não são permitidos ao usar tags no texto com a API do Threads. Portanto, qualquer tag que comece com o símbolo de hash será encerrada imediatamente antes destes caracteres:
    • Espaços, tabulações, caracteres de nova linha
    • Pontos (.)
    • E comercial (&)
    • Arroba (@)
    • Pontos de exclamação (!)
    • Pontos de interrogação (?)
    • Vírgulas (,)
    • Ponto e vírgula (;)
    • Dois pontos (:)

Links

Para anexar um link ao seu post, use o parâmetro link_attachment quando criar um objeto de mídia. Se nenhum parâmetro link_attachment for fornecido, o primeiro link criado em um post somente de texto por meio da API será configurado como o anexo de link. Esse anexo será exibido como um cartão de prévia para facilitar a interação e o clique.

Limitações

  • Esse recurso está disponível apenas para posts somente de texto. Ele não funcionará em posts de imagem, vídeo e carrossel.

Publicação

É possível anexar links ao fazer uma solicitação ao ponto de extremidade POST /threads para criar um objeto de mídia. Inclua o parâmetro a seguir na sua solicitação à API:

  • link_attachment: (somente para posts de texto) é o URL que deve ser anexado a um post do Threads e exibido como uma prévia do link. Deve ser um URL válido e de acesso público.
Exemplo de solicitação
curl -i -X POST \  
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=Link&access_token=<ACCESS_TOKEN>" 
  -d link_attachment=https://developers.facebook.com/
Exemplo de resposta
{
  "id": "1234567" // Threads Media Container ID
}

A solicitação acima cria um contêiner de post do Threads que, quando for publicado, anexará uma prévia do link à sua mídia.

Recuperação de mídia

O valor do URL de anexo do link pode ser recuperado ao fazer uma solicitação ao ponto de extremidade GET /threads ou GET /{threads_media_id} para recuperar objetos de mídia. Inclua o campo a seguir na sua solicitação à API:

  • link_attachment_url: é o URL anexado a um post do Threads.
Exemplo de solicitação
curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>?fields=id,link_attachment_url&access_token=<ACCESS_TOKEN>"
Exemplo de resposta
{
   "id": "12312312312123",
   "link_attachment_url": "https://developers.facebook.com/",
}

Especificações de mídia

Especificações de imagem

  • Formato: os tipos de imagem JPEG e PNG são os formatos oficialmente compatíveis para posts de imagem.
  • Tamanho do arquivo: máximo de 8 MB.
  • Limite de taxa de proporção: 10:1
  • Largura mínima: 320 (se necessário, a foto será redimensionada para atender ao tamanho mínimo)
  • Largura máxima: 1.440 (se necessário, a foto será redimensionada para atender ao tamanho máximo)
  • Altura: pode variar dependendo da largura e da taxa de proporção
  • Espaço de cores: sRGB. As imagens que usarem outros espaços de cores serão convertidas para o sistema sRGB.

Especificações de vídeo

  • Contêiner: MOV ou MP4 (MPEG-4 Parte 14), sem listas de edição com o moov atom na frente do arquivo.
  • Codec de áudio: AAC, taxa de amostragem máxima de 48 kHz, 1 ou 2 canais (mono ou estéreo).
  • Codec de vídeo: HEVC ou H.264, verificação progressiva, GOP fechado, chroma subsampling de 4:2:0.
  • Taxa de quadros: 23 a 60 FPS
  • Tamanho da imagem:
    • Máximo de colunas (pixels horizontais): 1.920
    • A taxa de proporção exigida é entre 0,01:1 e 10:1. No entanto, recomendamos a taxa de 9:16 para evitar cortes ou espaços em branco.
  • Taxa de bits do vídeo: VBR, máximo de 100 Mbps.
  • Taxa de bits do áudio: 128 kbps.
  • Duração: máximo de 300 segundos (5 minutos), mínimo mais que 0 segundo.
  • Tamanho do arquivo: máximo de 1 GB.