Публикации в Threads

Threads API можно использовать для публикации изображений, видео, текстов и кольцевых галерей.

В этом документе рассматриваются следующие темы:

• одиночные публикации;
• публикации в формате кольцевой галереи;
• метки тем и ссылки в публикациях.

Одиночные публикации

Размещение одного изображения, видео или текстовой публикации происходит в два этапа:

1. Выполните запрос к конечной точке POST /{threads-user-id}/threads, чтобы создать медиаконтейнер, используя изображение или видео, расположенное на общедоступном сервере, а также (при необходимости) текст. Эта конечная точка также позволяет создать медиаконтейнер только с текстом.
2. Используйте конечную точку POST /{threads-user-id}/threads_publish для публикации контейнера.

Ограничения

• Максимальная длина текстовой публикации — 500 символов.

Шаг 1. Создание медиаконтейнера Threads

Создайте медиаконтейнер Threads с помощью конечной точки POST /{threads-user-id}/threads.

Параметры

Ниже перечислены обязательные параметры. Полный список поддерживаемых параметров см. в справке по конечной точке POST /{threads-user-id}/threads.

• is_carousel_item — значение по умолчанию для одиночных публикаций: false. Задает изображение или видео, которое появится в кольцевой галерее.
• image_url — (только для изображений). Путь к файлу изображения. Мы создаем cURL изображения исходя из предоставленного URL, поэтому он должен указывать на общедоступный сервер.
• media_type — установите значение TEXT, IMAGE или VIDEO. Текущий тип медиаконтента. Примечание. Тип CAROUSEL не используется для одиночных публикаций.
• video_url — (только для видео). Путь к видеофайлу. Мы создаем cURL видео исходя из предоставленного URL, поэтому он должен указывать на общедоступный сервер.
• text — связанный с публикацией текст. Первый URL в поле text будет использоваться как ссылка для предпросмотра публикации. Для текстовых публикаций этот параметр обязателен.

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

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

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

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

Шаг 2. Публикация медиаконтейнера Threads

Опубликуйте ID контейнера, возвращенного в предыдущем шаге, с помощью конечной точки POST /{threads-user-id}/threads_publish. Перед публикацией медиаконтейнера Threads рекомендуется подождать как минимум 30 секунд, чтобы наш сервер успел полностью обработать загрузку. Подробнее см. в разделе, посвященном конечной точке статуса медиаконтейнера.

Параметры

• creation_id — ID медиаконтейнера Threads, созданный в запросе к конечной точке /threads.

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

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

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

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

Публикации с кольцевыми галереями

В публикации с кольцевой галереей можно использовать до 20 изображений и видео. Публикация кольцевых галерей происходит в три этапа:

1. Создайте отдельные контейнеры объектов для каждого изображения или видео, которые появятся в кольцевой галерее, с помощью конечной точки POST /{threads-user-id}/threads.
2. Создайте отдельный контейнер кольцевой галереи для объектов с помощью этой же конечной точки (POST /{threads-user-id}/threads).
3. Опубликуйте полученный ID контейнера кольцевой галереи с помощью конечной точки POST /{threads-user-id}/threads_publish.

В ограничении числа обращений публикации с кольцевыми галереями считаются одной публикацией.

Ограничения

• В кольцевых галереях может быть до 20 изображений и видео.
• Кольцевая галерея должна содержать не менее двух дочерних объектов.

Шаг 1. Создание контейнера объекта

Создайте контейнер объекта (изображения или видео, которое будет частью кольцевой галереи) с помощью конечной точки POST /{threads-user-id}/threads.

Параметры

Ниже перечислены обязательные параметры. Полный список поддерживаемых параметров см. в справке по конечной точке POST /{threads-user-id}/threads.

• is_carousel_item — задайте значение true. Указывает, что изображение или видео будет отображаться в кольцевой галерее.
• image_url — (только для изображений). Путь к файлу изображения. Мы создаем cURL изображения исходя из переданного URL, поэтому он должен указывать на общедоступный сервер.
• media_type — установите значение IMAGE или VIDEO. Указывает тип медиаобъекта: изображение или видео.
• video_url — (только для видео). Путь к видеофайлу. Мы создаем cURL видео исходя из переданного URL, поэтому он должен указывать на общедоступный сервер.

Примечание. Поле text необязательно для кольцевых галерей, однако первый URL в поле text будет использоваться в качестве ссылки на предпросмотр публикации.

В случае успеха API предоставит ID контейнера объекта, который можно использовать при создании контейнера кольцевой галереи.

Повторите этот процесс для каждого изображения или видео, которое должно появиться в кольцевой галерее.

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

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

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

{
  "id": "1234567"
}

Шаг 2. Создание контейнера кольцевой галереи

Создайте контейнер кольцевой галереи с помощью конечной точки POST /{threads-user-id}/threads.

Параметры

Ниже перечислены обязательные параметры. Полный список поддерживаемых параметров см. в справке по конечной точке POST /{threads-user-id}/threads.

• media_type — задайте значение CAROUSEL. Указывает, что контейнер предназначен для кольцевой галереи.
• children — список до 20 ID контейнеров (элементов изображений и (или) видео), которые нужно добавить в публикуемую кольцевую галерею, через запятую. В кольцевой галерее должно быть от 2 до 20 изображений и (или) видео.
• text — (необязательный параметр). Связанный с публикацией текст.

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

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

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

{
  "id": "1234567"
}

Шаг 3. Публикация контейнера кольцевой галереи

Опубликуйте кольцевую галерею с помощью конечной точки POST /{threads-user-id}/threads_publish. Профили Threads могут размещать не более 250 публикаций в течение 24 часов. Публикация кольцевой галереи считается одной публикацией.

Параметры

Следующие параметры обязательны.

• creation_id — ID контейнера кольцевой галереи.

В случае успеха API вернет ID медиаобъекта Threads для опубликованного альбома кольцевой галереи.

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

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

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

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

Метки тем и ссылки в публикациях

Темы и ссылки отображаются в публикациях таким образом, чтобы стимулировать вовлеченность пользователей.

Метки тем

Темы придают публикациям более социальный характер, объединяя их вокруг ключевых тем обсуждения. Чтобы добавить тему в публикацию, используйте параметр topic_tag или просто добавьте метку в текст публикации.

Использование параметра topic_tag

Примечание. В метках тем нельзя использовать следующие символы:

• точка (.);
• амперсанд (&).

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

Использование метки темы в тексте

Примечание. Этот метод не рекомендуется, но сохранен для обеспечения обратной совместимости.

Чтобы прикрепить тему к сообщению, можно просто добавить ее в текст сообщения. Через API можно задать только одну метку темы на публикацию, поэтому будет использоваться первая корректная метка, указанная в тексте (независимо от типа публикации — текст, изображение, видео, кольцевая галерея).

Информация, которую нужно учитывать при добавлении метки темы в публикацию с использованием метки в тексте:

• Действительная метка должна начинаться с символа решетки (#).
• В приложении текст метки отображается без символа решетки.
• Целые числа, перед которыми стоит символ решетки (например, #1), не интерпретируются как метки. В таком контексте предполагается, что символ # обозначает номер, а не метку.
• В метках в тексте в Threads API запрещены некоторые символы. Метки в тексте, которые начинаются с символа решетки, будут автоматически считаться законченными перед следующими символами:

  • пробелы, табуляция, символы новой строки;
  • точка (.);
  • амперсанд (&);
  • символ @;
  • восклицательный знак (!);
  • вопросительный знак (?);
  • запятая (,);
  • точка с запятой (;);
  • двоеточие (:).

Ссылки

Чтобы прикрепить к публикации ссылку, используйте при создании медиаобъекта параметр link_attachment. Если параметр link_attachment не указан, в текстовых публикациях, сделанных через API, первая ссылка в тексте будет автоматически настроена как вложенная. Она будет отображаться в виде карточки предпросмотра. Это способствует вовлечению пользователей и переходам по ссылке.

Ограничения

• Эта функция доступна только для текстовых публикаций. Она не работает для публикаций с изображением, видео или кольцевой галереей.

Размещение публикаций

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

• link_attachment — (только для текстовых публикаций). URL, который необходимо прикрепить к публикации Threads и показать в виде предпросмотра ссылки. Это должен быть действительный и общедоступный URL.

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

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/

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

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

Запрос выше создает контейнер публикации Threads, в котором после публикации будет отображаться предпросмотр ссылки.

Получение медиафайлов

Значение вложенной ссылки можно получить при выполнении запроса к конечной точке GET /threads или GET /{threads_media_id} для получения медиаобъектов. Добавьте в запрос API следующее поле:

• link_attachment_url — URL, прикрепленный к публикации Threads.

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

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

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

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

Спецификации медиаконтента