留言

代表 IG 影音內容物件的 IG 留言集合。

非自主留言

包含 IG 影音內容的廣告留言(即非自主留言)屬於不同類型,且不受支援。若要取得非自主留言,請使用行銷 API 並要求該廣告的 effective_instagram_story_id。接著您可以查詢傳回之編號的 /comments 關係連線,取得非自主 Instagram 留言集合。如需詳細資訊,請參閱 API 的貼文審核指南。

建立

建立影音內容物件的留言

POST /{ig-media-id}/comments?message={message}

建立 IG 影音素材物件的 IG 留言

限制

不支援直播影片 IG 影音素材的留言。

查詢字串參數

除非註明為必要參數,否則查詢字串參數是選用參數。

  • {message}(必要)- 要包含在留言內的文字。

權限

由建立 IG 影音內容物件的用戶所提供的存取權杖,有下列權限:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

如果此權杖的用戶是透過企業管理平台獲得粉絲專頁角色,也需有下列任一權限:

  • ads_management
  • pages_read_engagement
  • business_management

要求範例

POST graph.facebook.com
  /17895695668004550/comments?message=This%20is%20awesome!

回應範例

{
  "id": "17870913679156914"
}

讀取

取得影音內容物件的留言

GET /{ig-media-id}/comments

會傳回一份 IG 留言清單,這是 IG 影音內容物件的留言。

限制

  • 若使用 API 3.1 或更舊版本發出要求,系統會依時間先後順序傳回結果。若使用 3.2 或更新版本發出要求,則系統會依時間先後反向排序傳回結果。
  • 只會傳回最上層的留言。除非您是使用欄位擴充功能要求 replies 欄位,否則不會包含留言的回覆。
  • 每次查詢最多會傳回 50 則留言。

權限

由建立 IG 影音內容物件的用戶所提供的存取權杖,有下列權限:

  • instagram_basic
  • pages_show_list
  • pages_read_engagement

如果此權杖的用戶是透過企業管理平台獲得粉絲專頁角色,也需有下列任一權限:

  • ads_management
  • pages_read_engagement
  • business_management

要求範例

GET graph.facebook.com
  /17895695668004550/comments

回應範例

{
  "data": [
    {
      "timestamp": "2017-08-31T19:16:02+0000",
      "text": "This is awesome!",
      "id": "17870913679156914"
    },
    {
      "timestamp": "2017-08-31T18:10:30+0000",
      "text": "*Sniff*",
      "id": "17873440459141021"
    }
  ]
}

更新

不支援執行此作業。

刪除

不支援執行此作業。