留言次數

非原生留言

在包含 Instagram 媒體之廣告上的留言（即非原生留言）屬於不同類別，我們不予支援。如要獲取非原生留言，請使用推廣 API 並要求相應廣告的 effective_instagram_story_id。然後，您可以查詢所傳回編號的 /comments 關係連線，以獲取一系列非原生 Instagram 留言。如需了解更多資訊，請參閱推廣 API 的帖子審核指南。

建立

就媒體物件建立留言

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

就 Instagram 媒體物件建立 Instagram 留言。

限制

不支援在直播視像 Instagram 媒體上的留言。

查詢字串參數

除非另有要求，否則查詢字串參數為選用項目。

{message}（必要項目）— 要在留言中包含的文字。

權限

建立 Instagram 媒體物件的用戶之存取憑證，包含以下權限：

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

傳回 Instagram 媒體物件的 Instagram 留言清單。

限制

使用 v3.1 版或以下 API 版本發出的要求將以時間順序傳回結果。使用 v3.2 版及以上版本發出的要求將以時間倒序傳回結果。
僅傳回頂層留言。其中不包括留言的回覆，除非您使用欄位擴充功能要求 replies 欄位。
每次查詢最多可傳回 50 則留言。

權限

建立 Instagram 媒體物件的用戶之存取憑證，包含以下權限：

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"
    }
  ]
}

更新

我們並不支援這項操作。

刪除

我們並不支援這項操作。