API Đồ thị trên Instagram

Bình luận được nhắc đến của người dùng Instagram

Trả về dữ liệu liên quan đến Bình luận trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác @nhắc đến.

Tạo

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

Đọc

GET /{ig-user-id}?fields=mentioned_comment.comment_id

Trả về dữ liệu liên quan đến Bình luận trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác @nhắc đến.

Các giới hạn

Điểm cuối này sẽ trả về lỗi nếu tính năng bình luận đã bị tắt đối với File phương tiện trên Instagram mà Người dùng Instagram được @nhắc đến.

Yêu cầu

Loại Mô tả

Mã truy cập

Người dùng

Quyền

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list


Nếu người dùng ứng dụng đã được cấp một vai trò trên Trang qua Trình quản lý kinh doanh, bạn cũng sẽ cần có một trong những quyền sau:


ads_management
business_management

Nhiệm vụ

MANAGE, CREATE_CONTENT hoặc MODERATE

Cú pháp yêu cầu

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

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

Thông sốGiá trị

{access_token}
Bắt buộc
Chuỗi

Mã truy cập người dùng của người dùng ứng dụng.

{comment-id}
Bắt buộc
Chuỗi

ID của Bình luận trên Instagram mà Người dùng Instagram được @nhắc đến. ID này có trong phần tải dữ liệu thông báo Webhook.

{fields}
Danh sách được phân tách bằng dấu phẩy

Danh sách các Trường thông tin của Bình luận trên Instagram mà bạn muốn nhận được, được phân tách bằng dấu phẩy. Nếu bạn bỏ qua, các trường mặc định sẽ được trả về.

Trường

TrườngMô tả

id
Mặc định
Chuỗi

ID của Bình luận trên Instagram.

like_count
Chuỗi

Số lượt thích Bình luận trên Instagram.

media
Chuỗi

ID của File phương tiện trên Instagram nhận được Bình luận trên Instagram. Hãy sử dụng Phần mở rộng trường thông tin để lấy các trường thông tin khác về thực thể File phương tiện trên Instagram được trả về.

text
Mặc định
Chuỗi

Nội dung của Bình luận trên Instagram.

timestamp
Mặc định
Chuỗi

Ngày tạo Bình luận trên Instagram ở định dạng ISO 8601.

Phản hồi

Yêu cầu mẫu

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

Phản hồi mẫu

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Mở rộng trường

Bạn có thể mở rộng trường media bằng danh sách các trường thông tin của File phương tiện trên Instagram để lấy dữ liệu khác về thực thể File phương tiện trên Instagram nhận được bình luận. Ví dụ:

media{id,media_url}

Các lệnh gọi phiên bản 10.0 trở lên cho đến ngày 07/09/2021: Trường like_count của File phương tiện trên Instagram sẽ trả về 0 nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó.

Các lệnh gọi phiên bản 11.0 trở lên và tất cả các phiên bản vào ngày 07/09/2021: Nếu truy vấn gián tiếp một File phương tiện trên Instagram thông qua điểm cuối khác hoặc phần mở rộng trường thông tin, trường like_count sẽ không có trong phản hồi API nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Tuy nhiên, việc truy vấn trực tiếp File phương tiện trên Instagram (chỉ chủ sở hữu File phương tiện trên Instagram mới có thể thực hiện thao tác này) sẽ trả về số lượt thích thực tế, ngay cả khi số lượt thích của file phương tiện đó đã bị ẩn.

Ví dụ về yêu cầu có phần mở rộng trường thông tin

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

Ví dụ về phản hồi có phần mở rộng trường thông tin

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

Phân trang

Nếu bạn đang sử dụng phần mở rộng trường thông tin để truy cập một cạnh hỗ trợ tính năng phân trang theo vị trí con trỏ, nội dung phản hồi sẽ có con trỏ before và after nếu chứa nhiều trang dữ liệu. Tuy nhiên, khác với tính năng phân trang thông thường theo vị trí con trỏ, nội dung phản hồi sẽ không có trường thông tin previous hoặc next. Vì vậy, bạn sẽ phải sử dụng con trỏ before và after để tạo thủ công chuỗi truy vấn previous và next nhằm phân trang cho tập dữ liệu trả về.

Cập nhật

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

Xóa

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