Bình luận trên Instagram

Biểu thị bình luận cho đối tượng file phương tiện trên Instagram.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Ra mắt các trường sau đây:

legacy_instagram_comment_id

Dưới đây là các trường không được hỗ trợ:

comment_type
mentioned_instagram_users

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_manage_comments`	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read`

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

Lấy các trường và cạnh trong Bình luận trên Instagram.

Giới hạn

Bạn không thể thực hiện yêu cầu đối với những bình luận tìm thấy qua API Lượt nhắc trừ khi người bình luận yêu cầu. Thay vào đó, hãy sử dụng nút Bình luận được nhắc đến.
Hệ thống sẽ không trả về bình luận cho file phương tiện có giới hạn độ tuổi.
Hệ thống sẽ không trả về bình luận của Người dùng Instagram đã bị người dùng ứng dụng hạn chế, trừ khi Người dùng Instagram đó không bị hạn chế nữa và Bình luận được phê duyệt.
Người dùng chỉ đọc được bình luận cho File phương tiện trên Instagram trong video trực tiếp khi File phương tiện trên Instagram nhận được bình luận đang được phát.

Cú pháp yêu cầu

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`<API_VERSION>`	Phiên bản API.
`<HOST_URL>`	Phiên bản API.
`<IG_COMMENT_ID>`	Bắt buộc. ID của Bình luận trên Instagram.

Thông số chuỗi truy vấn

Khóa	Phần giữ chỗ	Giá trị
`access_token`	`<ACCESS_TOKEN>`	Bắt buộc. Mã truy cập dành cho Người dùng của người dùng ứng dụng.
`fields`	`<LIST_OF_FIELDS>`	Danh sách được phân tách bằng dấu phẩy gồm các trường trong Bình luận trên Instagram mà bạn muốn nhận được cho từng Bình luận trên Instagram trong tập hợp kết quả.

Trường

Tên trường	Mô tả
`from`	Một đối tượng chứa: `id` - ID trong Instagram (IGSID) của người dùng Instagram đã tạo Bình luận trên Instagram. `username` - Tên người dùng của người dùng Instagram đã tạo Bình luận trên Instagram.
`hidden`	Cho biết liệu bình luận có bị ẩn (`true`) hay không (`false`).
`id`	ID của Bình luận trên Instagram.
`like_count`	Số lượt thích của Bình luận trên Instagram.
`legacy_instagram_comment_id`	ID của bình luận trên Instagram được tạo cho điểm cuối API Marketing v21.0 trở xuống.
`media`	Một đối tượng chứa: `id` - ID của File phương tiện trên Instagram nhận được Bình luận trên Instagram. `media_product_type` - Giao diện đăng của File phương tiện trên Instagram nhận được Bình luận trên Instagram (tức là vị trí hiển thị File phương tiện trên Instagram).
`parent_id`	ID của Bình luận chính trên Instagram nếu bình luận này dành cho một Bình luận khác trên Instagram (tức là phản hồi cho một bình luận khác).
`replies`	Danh sách phản hồi (Bình luận trên Instagram) cho Bình luận trên Instagram.
`text`	Nội dung của Bình luận trên Instagram.
`timestamp`	Nhãn thời gian ở định dạng ISO 8601 cho biết thời điểm tạo Bình luận trên Instagram. Ví dụ: `2017-05-19T23:27:28+0000`.
`user`	ID của Người dùng Instagram đã tạo Bình luận trên Instagram. Chỉ được trả về nếu người dùng ứng dụng đã tạo Bình luận trên Instagram. Nếu không, hệ thống sẽ trả về `username`.
`username`	Tên người dùng của người dùng Instagram đã tạo Bình luận trên Instagram. Kể từ ngày 27/08/2024, bạn phải có quyền `instagram_manage_comments` (nếu ứng dụng của bạn dùng thông tin đăng nhập Facebook) và quyền `instagram_business_manage_comments` (nếu ứng dụng của bạn dùng thông tin đăng nhập Instagram) thì mới truy cập được trường `username` của một người dùng Instagram đã bình luận trên file phương tiện thuộc tài khoản công việc trên Instagram của người dùng ứng dụng nào đó.

Cạnh

Cạnh	Mô tả
`replies`	Lấy danh sách các Bình luận trên Instagram cho Bình luận trên Instagram; Tạo Bình luận trên Instagram cho Bình luận trên Instagram.

Phản hồi

Một đối tượng ở định dạng JSON chứa các trường và cạnh mặc định cũng như theo yêu cầu.

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL mẫu

Yêu cầu

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

Phản hồi

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

Cập nhật

Ẩn/hiển thị bình luận

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

Thông số chuỗi truy vấn

hide (bắt buộc) - Đặt là true để ẩn bình luận hoặc false để hiển thị bình luận.

Giới hạn

Bình luận của chủ sở hữu đối tượng file phương tiện trên đối tượng file phương tiện của chính họ sẽ luôn hiển thị, ngay cả khi bình luận được đặt là hide=true.
Bình luận cho File phương tiện trên Instagram trong video trực tiếp không được hỗ trợ.

Mã truy cập

Mã truy cập dành cho người dùng của người dùng sở hữu đối tượng file phương tiện nhận được bình luận.

Yêu cầu mẫu

Ẩn bình luận:

POST graph.instagram.com
  /17873440459141021?hide=true

Phản hồi mẫu

{
  "success": true
}

Xóa

Xóa bình luận

DELETE <HOST_URL>/<IG_COMMENT_ID>

Mã truy cập

Mã truy cập dành cho Người dùng của Người dùng đã tạo bình luận.

Giới hạn

Chỉ chủ sở hữu đối tượng nhận được bình luận mới có thể xóa bình luận, ngay cả khi người dùng cố xóa bình luận là tác giả của bình luận đó.
Bình luận cho File phương tiện trên Instagram trong video trực tiếp không được hỗ trợ.

Yêu cầu mẫu

DELETE graph.instagram.com
  /17873440459141021

Phản hồi mẫu

{
  "success": true
}