這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:9月5日
中文(香港) 更新時間:2021年12月22日

留言審核

您可以使用 Instagram 圖形 API 取得、回覆、刪除、隱藏/取消隱藏,以及停用/啟用應用程式用戶擁有之 IG 影音素材的留言。

自 2024 年 8 月 27 日起,若 Instagram 用戶在應用程式用戶的 Instagram 專業帳號之影音素材上留言,而您想要存取其 username 欄位時,將需要 instagram_manage_comments

您可以使用 Instagram 傳訊 API 傳送私密回覆(direct 訊息)給已對應用程式用戶的直播影片 IG 影音素材留言的用戶。請參閱 Instagram 傳訊的私密回覆文件,以瞭解如何操作。

端點

API 包含以下端點。請參閱每個端點的參考文件,瞭解參數和權限要求。

範例

取得及回覆留言

您可以取得影音內容物件的所有留言、分析及使用特定條件篩選傳回的資料集,然後回覆符合條件的任何留言。

首先請查詢 GET /{ig-media-id}/comments 端點,取得該影音內容的所有留言及留言編號:

要求範例

GET graph.facebook.com
  /17895695668004550/comments

回應範例

{
  "data": [
    {
      "timestamp": "2017-08-31T18:10:30+0000",
      "text": "I love this!",
      "id": "17873440459141021"
    },
    {
      "timestamp": "2017-08-31T19:16:02+0000",
      "text": "This is awesome!",
      "id": "17870913679156914"
    },
    ... // results truncated for brevity
  ]
}

接著,傳回與您所用條件相符的留言結果後,請進行結果剖析並使用相符的留言在留言對話串中回覆 Instagram 用戶(留言的用戶):

要求範例

POST graph.facebook.com
  /17870913679156914/replies?message=Thanks%20for%20sharing!

回應範例

{
  "id": "17873440459141029"
}

如果想回覆多則留言,可以使用單一要求批次處理回覆