Опросы

С помощью Threads API можно создавать публикации с опросами.

Ограничения

• Опросы можно прикреплять к публикациям, содержащим только текст.

Создание публикации с опросом

К запросу к конечной точке POST /threads для создания медиаобъекта можно прикрепить опрос. Добавьте в запрос следующий параметр:

• poll_attachment — объект JSON, содержащий варианты ответов на опрос.

Объект poll_attachment должен иметь следующий вид:

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

Объект poll_attachment должен содержать от 2 до 4 вариантов ответа. Каждый указываемый вариант должен иметь длину от 1 до 25 символов.

Пример запроса

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

Пример ответа

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

Этот запрос создаст контейнер для публикации в Threads. После публикации к ней будет прикреплен опрос с заданными вариантами ответов.

Получение медиаобъектов

Чтобы получить медиаобъекты, отправьте запрос к конечной точке GET /threads или GET /{threads-media-id}. Добавьте в запрос API следующее поле:

• poll_attachment — вложение опроса для публикации.

Пример запроса

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}

Пример ответа

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

Примечание. Поля для вариантов C и D будут возвращаться, только если они имеются в получаемом запросе.