File phương tiện được nhắc đến

Trả về dữ liệu liên quan đến File phương tiện trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác @nhắc đến trong chú thích.

Tạo

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

Đọc

GET /{ig-user-id}?fields=mentioned_media.media_id

Trả về dữ liệu liên quan đến File phương tiện trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác @nhắc đến trong chú thích.

Các giới hạn

Không hỗ trợ Lượt nhắc trên Tin.
Không hỗ trợ bình luận trên các ảnh mà bạn được gắn thẻ.
Webhooks sẽ không được gửi nếu File phương tiện có bình luận hoặc lượt @nhắc đến do một tài khoản ở chế độ riêng tư tạo.

Yêu cầu

Loại Mô tả

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`

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_media.media_id({media-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 dành cho người dùng của người dùng ứng dụng.
`{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 File phương tiệ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ỏ qua, các Trường thông tin mặc định sẽ được trả về.
`{media-id}` Bắt buộc Chuỗi	ID của File phương tiện trên Instagram mà Người dùng Instagram được @nhắc đến trong chú thích. ID này có trong phần tải dữ liệu thông báo của Webhook.

Trường

Trường	Mô tả
`caption` Chuỗi	Nội dung chú thích. Các chú thích @nhắc đến Người dùng Instagram sẽ không có ký hiệu `@`, trừ khi người dùng ứng dụng đã tạo đối tượng File phương tiện trên Instagram có chú thích được đưa ra.
`comments` Đối tượng	Danh sách các Bình luận trên Instagram cho File phương tiện trên Instagram. Nếu sử dụng Phần mở rộng trường thông tin để lấy nội dung bình luận thì nội dung @nhắc đến Người dùng Instagram sẽ không có ký hiệu `@`, trừ khi người dùng ứng dụng đã tạo đối tượng File phương tiện trên Instagram có chú thích được đưa ra.
`comments_count` Chuỗi	Số lượng Bình luận trên Instagram cho File phương tiện trên Instagram.
`id` Mặc định Chuỗi	ID của File phương tiện trên Instagram.
`like_count` Chuỗi	Số lượt thích trên file phương tiện. Không bao gồm lượt thích trên file phương tiện trong album và lượt thích trên bài viết quảng cáo được tạo từ file phương tiện đó. Bao gồm lượt phản hồi bình luận. Các lệnh gọi v10.0 trở xuống: giá trị sẽ là `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 v11.0 trở lên: sẽ không có trường thông tin nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Giá trị sẽ là `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 đó.
`media_type` Chuỗi	Loại của File phương tiện trên Instagram: `CAROUSEL_ALBUM`, `IMAGE`, `STORY` hoặc `VIDEO`.
`media_url` Chuỗi	URL của File phương tiện đã đăng trên Instagram.
`owner` Chuỗi	ID của Người dùng Instagram đã tạo File phương tiện trên Instagram. Chỉ được trả về nếu người dùng ứng dụng đã tạo đối tượng File phương tiện trên Instagram. Nếu không, hệ thống sẽ trả về trường `username`.
`timestamp` Chuỗi	Ngày tạo File phương tiện trên Instagram ở định dạng ISO 8601.
`username` Chuỗi	Tên người dùng của Người dùng Instagram đã tạo File phương tiện trên Instagram.

Yêu cầu mẫu

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Phản hồi mẫu

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Lưu ý rằng trong ví dụ ở trên, API này đã loại bỏ ký hiệu @ ở đầu khỏi chú thích gốc (@metricsaurus headquarters!) vì người dùng ứng dụng không tạo chú thích đó.

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ợ.