Publications Threads

Vous pouvez utiliser l’API Threads pour publier des publications de type image, vidéo, texte ou carrousel.

Sommaire du document :

• Publications de thread uniques
• Publications en carrousel
• Tags et liens des sujets dans les publications

Publications de thread uniques

La publication d’une image, d’une vidéo ou d’un texte unique se fait en deux étapes :

1. Utilisez le point de terminaison POST /{threads-user-id}/threads pour créer un conteneur de contenu multimédia avec une image ou une vidéo hébergée sur votre serveur public et un texte facultatif. Vous pouvez également utiliser ce point de terminaison pour créer un conteneur de contenu multimédia avec du texte uniquement.
2. Utilisez le point de terminaison POST /{threads-user-id}/threads_publish pour publier ce conteneur.

Limites

• Les publications texte sont limitées à 500 caractères.

Étape 1 : créer un conteneur de contenu multimédia Threads

Utilisez le point de terminaison POST /{threads-user-id}/threads pour créer un conteneur de contenu multimédia Threads.

Paramètres

Les paramètres suivants sont obligatoires. Consultez la référence du point de terminaison POST /{threads-user-id}/threads pour découvrir les paramètres supplémentaires pris en charge.

• is_carousel_item : la valeur par défaut est false pour les publications de thread uniques. Indique une image ou une vidéo qui apparaîtra dans un carrousel.
• image_url : (Pour les images uniquement.) Chemin d’accès à l’image. Comme nous effectuerons un cURL de votre image avec l’URL fournie, elle doit se trouver sur un serveur public.
• media_type : définissez ce paramètre sur TEXT, IMAGE ou VIDEO. Indique le type de contenu multimédia actuel. Remarque : le type CAROUSEL n’est pas disponible pour les publications de thread uniques.
• video_url : (Pour les vidéos uniquement.) Chemin d’accès à la vidéo. Comme nous effectuerons un cURL de votre vidéo avec l’URL fournie, elle doit se trouver sur un serveur public.
• text : texte associé à la publication. La première URL incluse dans le champ text sera utilisée comme aperçu du lien pour la publication. Pour les publications contenant uniquement du texte, ce paramètre est obligatoire.

Exemple de requête

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>"

Exemple de réponse

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

Étape 2 : publier un conteneur de contenu multimédia Threads

Utilisez le point de terminaison POST /{threads-user-id}/threads_publish pour publier l’ID de conteneur renvoyé à l’étape précédente. Il est recommandé d’attendre environ 30 secondes avant de publier un conteneur de contenu multimédia Threads pour permettre au serveur de traiter l’importation. Consultez le point de terminaison du statut du conteneur de contenu multimédia pour en savoir plus.

Paramètres

• creation_id : identifiant du conteneur de contenu multimédia Threads créé à partir du point de terminaison /threads.

Exemple de requête

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

Exemple de réponse

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

Publications carrousels

Vous pouvez publier jusqu’à 20 images et/ou vidéos dans une publication carrousel. La publication de carrousels est un processus en trois étapes :

1. Utilisez le point de terminaison POST /{threads-user-id}/threads pour créer des conteneurs d’éléments individuels pour chaque image et vidéo qui apparaîtra dans le carrousel.
2. Utilisez à nouveau le point de terminaison POST /{threads-user-id}/threads pour créer un conteneur de carrousel unique pour les éléments.
3. Utilisez le point de terminaison POST /{threads-user-id}/threads_publish pour publier le conteneur de carrousel.

Les publications carrousels comptent comme une seule publication dans le plafond du profil.

Limites

• Les carrousels sont limités à 20 images et/ou vidéos.
• Les carrousels nécessitent un minimum de deux enfants.

Étape 1 : créer un conteneur d’éléments

Utilisez le point de terminaison POST /{threads-user-id}/threads pour créer un conteneur d’éléments pour l’image ou la vidéo qui apparaîtra dans le carrousel.

Paramètres

Les paramètres suivants sont obligatoires. Consultez la référence du point de terminaison POST /{threads-user-id}/threads pour découvrir les paramètres supplémentaires pris en charge.

• is_carousel_item : défini sur true. Indique que l’image ou la vidéo apparaîtra dans un carrousel.
• image_url : (Pour les images uniquement.) Chemin d’accès à l’image. Comme nous effectuerons un cURL de votre image avec l’URL transmise, elle doit se trouver sur un serveur public.
• media_type : défini sur IMAGE ou VIDEO. Indique que le contenu multimédia est une image ou une vidéo.
• video_url : (Pour les vidéos uniquement.) Chemin d’accès à la vidéo. Comme nous effectuerons un cURL de votre vidéo avec l’URL transmise, elle doit se trouver sur un serveur public.

Remarque : bien que le champ text soit facultatif pour les publications carrousels, la première URL incluse dans le champ text sera utilisée comme aperçu du lien pour la publication.

Si l’opération réussit, l’API renvoie un ID de conteneur d’éléments, qui peut être utilisé pour la création du conteneur de carrousel.

Répétez le processus pour chaque image ou vidéo que vous souhaitez voir apparaître dans le carrousel.

Exemple de requête

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>"

Exemple de réponse

{
  "id": "1234567"
}

Étape 2 : créer un conteneur de carrousel

Utilisez le point de terminaison POST /{threads-user-id}/threads pour créer un conteneur de carrousel.

Paramètres

Les paramètres suivants sont obligatoires. Consultez la référence du point de terminaison POST /{threads-user-id}/threads pour découvrir les paramètres supplémentaires pris en charge.

• media_type : défini sur CAROUSEL. Indique que le conteneur est destiné à un carrousel.
• children : liste de 20 ID de conteneur au maximum (séparés par une virgule) pour chaque image et/ou vidéo que vous souhaitez voir apparaître dans le carrousel publié. Les carrousels peuvent contenir entre 2 et 20 images et/ou vidéos.
• text : (Facultatif.) Texte associé à la publication.

Exemple de requête

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>"

Exemple de réponse

{
  "id": "1234567"
}

Étape 3 : publier le conteneur de carrousel

Utilisez le point de terminaison POST /{threads-user-id}/threads_publish pour publier une publication carrousel. Les profils sont limités à 250 publications par fenêtre de 24 heures. La publication d’un carrousel compte comme une seule publication.

Paramètres

Les paramètres suivants sont obligatoires.

• creation_id : ID du conteneur de carrousel.

Si l’opération réussit, l’API renvoie l’ID de contenu multimédia Threads d’un album carrousel.

Exemple de requête

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

Exemple de réponse

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

Tags et liens de sujets dans les publications

Les sujets et les liens apparaissent dans les publications de manière à inciter l’interaction.

Tags de sujets

Grâce aux sujets, les publications peuvent s’organiser autour de sujets de discussion centraux et revêtir un caractère social. Vous pouvez inclure un sujet dans une publication soit avec le paramètre topic_tag, soit par inclusion du tag dans le texte de la publication.

Avec le paramètre topic_tag

Remarque : les caractères suivants ne sont pas autorisés dans les tags de sujet :

• Points (.)
• Esperluettes (&)

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

Tag inséré dans le texte

Remarque : si cette méthode n’est pas privilégiée, elle est tout de même conservée pour des raisons de rétrocompatibilité.

Un sujet en lien avec la publication peut également y être ajouté en l’incorporant au texte de la publication. Chaque publication autorise un seul tag. Par conséquent, le premier tag valide inclus dans une publication quel qu’en soit le type (texte uniquement, image, vidéo, carrousel) via l’API est considéré comme le tag de cette publication.

Informations à garder à l’esprit lors de l’ajout d’un tag à une publication par insertion dans le texte :

• Les tags valides commencent par le signe dièse (#).
• Le texte est également configuré dans l’application sans le signe dièse.
• Les nombres entiers précédés du signe dièse (par exemple, #1) ne seront pas convertis en tag. En effet, dans ce cas, le signe dièse (#) est assimilé à un signe de numéro.
• Les caractères suivants ne sont pas autorisés dans les tags insérés dans le texte à l’aide de l’API Threads. Par conséquent, tout tag commençant par un signe dièse se terminera juste avant ces caractères :

  • Espaces, tabulations, caractères de nouvelle ligne
  • Points (.)
  • Esperluettes (&)
  • Arobases (@)
  • Points d’exclamation (!)
  • Points d’interrogation (?)
  • Virgules (,)
  • Points-virgules (;)
  • Deux-points (:)

Liens

Pour associer un lien à votre publication, utilisez le paramètre link_attachment lors de la création d’un objet multimédia. Si aucun paramètre link_attachment n’est fourni, le premier lien établi dans une publication contenant uniquement du texte via l’API est configuré comme pièce jointe de lien (affichée sous la forme d’une carte d’aperçu), ce qui facilite les interactions et les clics.

Limites

• Cette fonctionnalité n’est disponible que pour les publications au format texte uniquement. Elle ne s’applique pas aux publications de type image, vidéo et carrousel.

Publication

Des liens peuvent être associés lors d’une requête au point de terminaison POST /threads pour créer un objet multimédia. Veillez à ajouter le paramètre suivant à la requête d’API :

• link_attachment : (Pour les publications texte uniquement.) URL qui doit être associée à une publication Threads et affichée comme aperçu de lien. Il doit s’agir d’une URL valide accessible au public.

Exemple de requête

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/

Exemple de réponse

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

La requête ci-dessus crée un conteneur de publication Threads qui, une fois publié, associe un aperçu de lien à votre contenu multimédia.

Récupération de contenu multimédia

La valeur de l’URL de pièce jointe de lien peut être récupérée lors d’une requête au point de terminaison GET /threads ou GET /{threads_media_id} pour récupérer les objets multimédias. Veillez à ajouter le champ suivant à la requête d’API :

• link_attachment_url : URL associée à une publication Threads.

Exemple de requête

curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>?fields=id,link_attachment_url&access_token=<ACCESS_TOKEN>"

Exemple de réponse

{
   "id": "12312312312123",
   "link_attachment_url": "https://developers.facebook.com/",
}

Spécifications du contenu multimédia