Sondages

Vous pouvez utiliser l’API Threads pour créer des publications avec des sondages.

Limites

• Les sondages ne peuvent être joints qu’à des publications au format texte uniquement.

Créer une publication avec un sondage

Vous pouvez joindre un sondage lors d’une requête au point de terminaison POST /threads pour créer un objet multimédia. Ajoutez le paramètre suivant dans votre requête :

• poll_attachment — objet JSON contenant les options du sondage.

L’objet poll_attachment doit être au format :

{
  "option_a": "first option",
  "option_b": "second option",
  "option_c": "third option", // Optional
  "option_d": "fourth option" // Optional
}

L’objet poll_attachment doit contenir entre 2 et 4 options. Chaque option à inclure doit comprendre entre 1 et 25 caractères.

Exemple de requête

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=MyText&access_token=<ACCESS_TOKEN>" \
-d poll_attachment='{"option_a":"first option", "option_b":"second option"}'

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é, comprendra un sondage en pièce jointe avec les options fournies.

Récupération de contenu multimédia

Faites 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 :

• poll_attachment — Sondage joint à la publication.

Exemple de requête

curl -i -X GET \
"https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>&access_token=<ACCESS_TOKEN>" \
-d fields=id,poll_attachment{option_a,option_b,option_c,option_d,option_a_votes_percentage,option_b_votes_percentage,option_c_votes_percentage,option_d_votes_percentage,total_votes,expiration_timestamp}

Exemple de réponse

{
  "id": "1234567", // Threads Media ID
  "poll_attachment": {
    "option_a": "first option",
    "option_b": "second option",
    "option_c": "third option",
    "option_d": "fourth option",
    "option_a_votes_percentage": 0.10, // Percentage of votes for first option
    "option_b_votes_percentage": 0.20,
    "option_c_votes_percentage": 0.15,
    "option_d_votes_percentage": 0.55,
    "total_votes": 100,
    "expiration_timestamp": "2025-01-01T23:00:00+0000" // Time when the poll expires
  }
}

Remarque : les champs des options C et D seront renvoyés uniquement s’ils sont disponibles pour le sondage à récupérer.