Threads 게시물

Threads API를 사용하여 이미지, 동영상, 텍스트 또는 슬라이드 게시물을 게시합니다.

이 문서에서 다루는 내용은 다음과 같습니다.

• 단일 스레드 게시물
• 슬라이드 게시물
• 게시물의 주제 태그 및 링크

단일 스레드 게시물

단일 이미지, 동영상 또는 텍스트 게시물을 게시하는 절차는 2단계로 구성됩니다.

1. POST /{threads-user-id}/threads 엔드포인트를 사용하여 공용 서버에서 호스팅되는 이미지 또는 동영상과 선택적 텍스트를 사용하는 미디어 컨테이너를 만듭니다. 또는 이 엔드포인트를 사용하여 텍스트만 포함된 미디어 컨테이너를 만들 수 있습니다.
2. POST /{threads-user-id}/threads_publish 엔드포인트를 사용하여 컨테이너를 게시합니다.

제한 사항

• 텍스트 게시물은 500자로 제한됩니다.

1단계: Threads 미디어 컨테이너 만들기

POST /{threads-user-id}/threads 엔드포인트를 사용하여 Threads 미디어 컨테이너를 만듭니다.

매개변수

다음 매개변수는 필수입니다. 추가적으로 지원되는 매개변수는 POST /{threads-user-id}/threads 엔드포인트 참고 자료를 참조하세요.

• is_carousel_item - 단일 스레드 게시물에 대한 기본값은 false입니다. 슬라이드에 표시할 이미지 또는 동영상을 나타냅니다.
• image_url - (이미지 전용.) 이미지에 대한 경로입니다. 제공되는 URL을 사용하여 cURL로 이미지를 불러오기 때문에 이미지가 공용 서버에 있어야 합니다.
• media_type - TEXT, IMAGE 또는 VIDEO로 설정합니다. 현재 미디어 유형을 나타냅니다. 참고:CAROUSEL 유형은 단일 스레드 게시물에 제공되지 않습니다.
• video_url - (동영상 전용.) 동영상 경로입니다. 제공되는 URL을 사용하여 cURL로 동영상을 불러오기 때문에 동영상이 공용 서버에 있어야 합니다.
• text - 게시물과 관련된 텍스트입니다. text 필드에 포함된 첫 번째 URL은 게시물의 링크 미리 보기로 사용됩니다. 텍스트만 있는 게시물의 경우 이 매개변수가 필수입니다.

요청 예시

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 미디어 컨테이너 게시

POST /{threads-user-id}/threads_publish 엔드포인트를 사용하여 이전 단계에서 반환된 컨테이너 ID를 게시합니다. 서버가 업로드를 완전히 처리할 수 있도록 충분한 시간적 여유를 제공하기 위해 평균 30초 정도 기다린 후 Threads 미디어 컨테이너를 게시하는 것이 좋습니다. 자세한 내용은 미디어 컨테이너 상태 엔드포인트를 참조하세요.

매개변수

• creation_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개까지 게시할 수 있습니다. 슬라이드를 게시하는 절차는 3단계로 구성됩니다.

1. POST /{threads-user-id}/threads 엔드포인트를 사용하여 슬라이드에 표시될 각 이미지와 동영상의 개별 항목 컨테이너를 만듭니다.
2. 다시 POST /{threads-user-id}/threads 엔드포인트를 사용하여 항목에 대해 단일 슬라이드 컨테이너를 만듭니다.
3. POST /{threads-user-id}/threads_publish 엔드포인트를 사용하여 슬라이드 컨테이너를 게시합니다.

슬라이드 게시물은 프로필의 사용 제한에서 단일 게시물로 간주됩니다.

제한 사항

• 슬라이드는 이미지, 동영상 또는 그 두 가지의 조합을 최대 20개로 제한합니다.
• 슬라이드는 최소 2개의 하위 항목이 필요합니다.

1단계: 항목 컨테이너 만들기

POST /{threads-user-id}/threads 엔드포인트를 사용하여 슬라이드에 표시될 이미지 또는 동영상의 항목 컨테이너를 만듭니다.

매개변수

다음 매개변수는 필수입니다. 추가적으로 지원되는 매개변수는 POST /{threads-user-id}/threads 엔드포인트 참고 자료를 참조하세요.

• is_carousel_item - true로 설정합니다. 이미지 또는 동영상이 슬라이드에 표시됨을 나타냅니다.
• image_url - (이미지 전용.) 이미지 경로입니다. 전달된 URL을 사용하여 cURL로 이미지를 불러오기 때문에 이미지가 공용 서버에 있어야 합니다.
• media_type - IMAGE 또는 VIDEO으로 설정합니다. 미디어가 이미지 또는 동영상임을 나타냅니다.
• video_url - (동영상 전용.) 동영상 경로입니다. 전달된 URL을 사용하여 cURL로 동영상을 불러오기 때문에 동영상이 공용 서버에 있어야 합니다.

참고:text 필드는 슬라이드 게시물의 선택 항목이지만 text 필드에 포함된 첫 번째 URL은 게시물의 링크 미리 보기로 사용됩니다.

작업이 성공할 경우 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 - 게시된 슬라이드에 표시해야 하는 각 이미지 및/또는 동영상의 컨테이너 ID(최대 20개)로 구성된 쉼표로 구분된 리스트입니다. 슬라이드에는 이미지, 동영상 또는 그 두 가지의 조합을 모두 합쳐 최소 2개 이상, 최대 10개까지 포함할 수 있습니다.
• 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 엔드포인트를 사용하여 슬라이드 게시물을 게시합니다. 프로필은 24시간 이내에 게시물을 최대 250개까지 게시할 수 있습니다. 슬라이드를 게시할 경우 이는 단일 게시물로 간주됩니다.

매개변수

다음 매개변수는 필수입니다.

• creation_id - 슬라이드 컨테이너 ID입니다.

작업이 성공하면 API가 슬라이드 사진첩의 Threads 미디어 ID를 반환합니다.

요청 예시

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 - (텍스트 게시물 전용.) Threads 게시물에 연결하고 링크 미리 보기로 표시해야 하는 URL입니다. 이는 유효하고 공개적으로 액세스할 수 있는 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} 엔드포인트로 요청을 보내 미디어 개체를 가져올 때 링크 첨부 URL의 값을 가져올 수 있습니다. API 요청에 다음 필드를 포함하세요.

• link_attachment_url - Threads 게시물에 첨부된 URL입니다.

요청 예시

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/",
}

미디어 사양