Threads 貼文

您可以使用 Threads API 來發佈圖像、影片、文字或輪播貼文。

本文內容：

• 單串貼文
• 輪播貼文
• 貼文中的主題標籤和連結

單串貼文

發佈單一圖像、影片或文字貼文的程序包含兩個步驟：

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 —（僅適用於圖像。）圖像的路徑。我們會使用所提供的網址為您的圖像建立 cURL，因此該圖像必須位在公開伺服器上。
• media_type — 設為 TEXT、IMAGE 或 VIDEO。表示目前的影音內容類型。注意：CAROUSEL 類型不適用於單串貼文。
• video_url —（僅適用於影片。）影片的路徑。我們會使用所提供的網址為您的影片建立 cURL，因此該影片必須位在公開伺服器上。
• text — 與貼文相關的文字。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 影音內容容器

使用 POST /{threads-user-id}/threads_publish 端點來發佈上一個步驟中傳回的容器編號。建議在發佈 Threads 影音內容容器之前，平均等待 30 秒的時間，讓我們的伺服器有足夠的時間完全處理上傳內容。詳情請參閱影音內容容器狀態端點。

參數

• 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 個圖像、影片或兩者的混合。發佈輪播貼文的程序包含三個步驟：

1. 使用 POST /{threads-user-id}/threads 端點，為輪播中顯示的每個圖像和影片建立個別的項目容器。
2. 再次使用 POST /{threads-user-id}/threads 端點，為這些項目建立單一輪播容器。
3. 使用 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，因此該圖像必須位在公開伺服器上。
• media_type — 設為 IMAGE 或 VIDEO。表示影音內容為圖像或影片。
• video_url —（僅適用於影片。）影片的路徑。我們會使用傳入的網址為您的影片建立 cURL，因此該影片必須位在公開伺服器上。

注意：雖然 text 欄位是輪播貼文的選用欄位，但 text 欄位中包含的第一個網址會用作貼文的連結預覽。

如果操作成功，API 會傳回項目容器編號，可供建立輪播容器時使用。

針對應顯示在輪播中的每個圖像或影片重複此程序。

要求範例

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 個容器編號，代表應顯示在所發佈輪播中的每個圖像和／或影片。輪播中可以包含的圖像、影片或兩者混合總數為最少 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 端點來發佈輪播貼文。個人檔案限制在 24 小時期間內只能發佈 250 則貼文。發佈輪播廣告計為單一貼文。

參數

下列為必要參數。

• creation_id — 輪播容器編號。

如果操作成功，API 會傳回輪播相簿的 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

使用 in-text 主題標籤

注意：此並非為偏好的方法，但為了向下相容而保留。

您也可以將主題附加到貼文中，方法是在貼文的文字中加入內嵌主題。每則貼文只允許使用一個主題標籤，因此透過 API 包含在任何類型（純文字、圖像、影片、輪播）貼文中的第一個有效標籤，即視為該貼文的標籤。

使用 in-text 標籤在貼文中加入主題標籤時應謹記的資訊：

• 有效的標籤以 # 符號開頭。
• 文字配置在應用程式中也沒有 # 符號。
• 前置 # 符號的整數（例如 #1）不會轉換成標籤。這是因為在此情境中，會假定 # 為表示數字符號。
• 透過 Threads API 使用 in-text 標籤時，不允許使用下列字元，因此任何以 # 符號開頭的 in-text 標籤，都會在這些字元之前結束：

  • 空格、欄標、換行字元
  • 句點（.）
  • & 符號
  • @ 符號
  • 驚嘆號（!）
  • 問號（?）
  • 逗號（,）
  • 分號（;）
  • 冒號（:）

連結

若要在貼文中附加連結，請在建立影音內容物件時使用 link_attachment 參數。如果未提供 link_attachment 參數，則透過 API 在純文字貼文中建立的第一個連結即配置為連結附件，並以預覽卡片的形式顯示，以方便進行互動和點擊。

限制

• 此功能僅適用於純文字貼文，不適用於圖像、影片和輪播貼文。

發佈

向 POST /threads 端點發出要求來建立影音內容物件時，可以附加連結。請務必在 API 要求中包含下列參數：

• link_attachment —（僅適用於文字貼文。）應附加至 Threads 貼文並顯示為連結預覽的網址。這必須是可公開存取的有效網址。

要求範例

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 — 附加至 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/",
}

影音內容規格