Instagram 用戶媒體

代表 Instagram 用戶上的一系列 Instagram 媒體物件。

建立

POST /{ig-user-id}/media

• 建立圖片、輪播內容、限時動態或連續短片 Instagram 容器，以在帖子發佈過程中使用。請參閱內容發佈指南，了解完整的發佈步驟。

限制

一般限制

• 容器會於 24 小時後過期。
• 如果與目標 Instagram 專業帳戶連結的專頁需要專頁發佈授權 (PPA)，則必須完成此授權，否則要求將會失敗。
• 如果與目標 Instagram 專業帳戶連結的專頁需要雙重驗證，則 Facebook 用戶亦必須已執行雙重驗證，否則要求將會失敗。
• 不支援發佈至 Instagram TV。

Reels 限制

• Reels 在相簿輪播內容中無法顯示。
• 在發佈內容時將套用帳戶私隱設定。舉例來說，如有啟用「允許混合配搭」設定，發佈的連續短片便會在發佈時啟用混合配搭設定，但您亦可透過 Instagram 應用程式在已發佈的連續短片上手動停用此設定。
• 音樂標註僅可用於原始音訊。

限時動態限制

• 限時動態會於 24 小時後過期。
• 支援使用影片網址或 Reels 網址，但兩者不可同時使用。
• 不支援發佈貼圖（即連結、投票活動、地點）。

必要條件

圖片規格

• 格式：JPEG
• 檔案大小：不超過 8 MB
• 長闊比例：必須介乎 4:5 至 1.91:1
• 闊度下限：320（必要時將放大至下限要求）
• 闊度上限：1440（必要時將縮小至上限要求）
• 高度：不定，取決於闊度和長闊比例
• 色彩空間：sRGB圖片如使用其他色彩空間，系統會將其色彩空間轉換為 sRGB

連續短片規格

連續短片的規格如下所示：

• 容器：MOV 或 MP4 (MPEG-4 Part 14)，沒有編輯清單，moov atom 位於檔案前面
• 音訊編碼方式：AAC，取樣頻率不超過 48khz，1 或 2 個頻道（單聲道或立體聲）
• 影片編碼方式：HEVC 或 H264，循序式掃描，封閉式 GOP，4:2:0 色度次取樣
• 影格速率：23-60 FPS
• 圖片大小：

  • 欄數上限（水平像素）：1920
  • 長闊比例要求為 0.01:1 至 10:1，但我們建議使用 9:16 的長闊比例，以避免圖片被裁剪或出現空白位置。
• 影片位元速率：VBR，不超過 25 Mbps
• 音訊位元速率：128 kbps
• 時間：不超過 15 分鐘，不短於 3 秒
• 檔案大小：不超過 1 GB

連續短片封面相片的規格如下所示：

• 格式：JPEG
• 檔案大小：不超過 8 MB
• 色彩空間：sRGB圖片如使用其他色彩空間，系統會將其色彩空間轉換為 sRGB
• 長闊比例：我們建議使用 9:16 的長闊比例，以避免圖片被裁剪或出現空白位置。如果原始圖片的長闊比例不是 9:16，我們會裁剪該圖片並使用正中的 9:16 長方形作為該連續短片的封面相片。如將連續短片分享到動態消息，我們會裁剪該圖片並使用正中的 1:1 方形作為動態消息帖子的封面相片。

限時動態圖片規格

• 格式：JPEG
• 檔案大小：不超過 8 MB
• 長闊比例：我們建議使用 9:16 的長闊比例，以避免圖片被裁剪或出現空白位置
• 色彩空間：sRGB圖片如使用其他色彩空間，系統會將其色彩空間轉換為 sRGB

限時動態影片規格

• 容器：MOV 或 MP4（MPEG-4 Part 14），檔案前面沒有編輯清單和 moov atom
• 音訊編碼方式：AAC，取樣頻率不超過 48khz，1 或 2 個頻道（單聲道或立體聲）
• 影片編碼方式：HEVC 或 H264，循序式掃描，封閉式 GOP，4:2:0 色度次取樣
• 影格速率：23-60 FPS
• 圖片大小：

  • 欄數上限（水平像素）：1920
  • 長闊比例要求為 0.1:1 至 10:1，但我們建議使用 9:16 的長闊比例，以避免影片被裁剪或出現空白位置
• 影片位元速率：VBR，不超過 25 Mbps
• 音訊位元速率：128 kbps
• 時間：不超過 60 秒，不短於 3 秒
• 檔案大小：不超過 100 MB

要求語法

圖片容器

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

連續短片容器

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

輪播內容容器

僅限輪播內容容器。如要建立輪播項目容器，您需要建立圖片或影片容器（不支援連續短片）。請參閱輪播帖子，了解完整發佈步驟。

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

圖片限時動態容器

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

影片限時動態容器

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

路徑參數

查詢字串參數

回應

包含 Instagram 容器編號的 JSON 格式物件；此編號可讓您用來發佈容器。

影片上載為非同步操作，因此收到容器編號並不能確保上載成功。為了確認影片已經上載，請在 Instagram 容器中要求 status_code 欄位。如果值為 FINISHED，則影片已成功上載。

{
  "id":"{ig-container-id}"
}

要求範例

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

回應範例

{
  "id": "17889455560051444"
}

讀取

GET /{ig-user-id}/media

獲取 Instagram 用戶上的所有 Instagram 媒體。

限制

• 最多傳回 10,000 個最近建立的媒體。
• 不支援限時動態 Instagram 媒體，改為使用 GET /{ig-user-id}/stories 端點。

必要條件

時間型分頁

此端點支援基於時間的分頁，包括帶有 Unix 時戳或 strtotime 資料值的 since 和 until 查詢字串參數，以定義時間範圍。

要求範例

GET graph.facebook.com/17841405822304914/media 

回應範例

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

更新

不支援這項操作。

刪除

不支援這項操作。