API Đồ thị trên Instagram

Thẻ

Biểu thị tập hợp đối tượng File phương tiện trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác gắn thẻ.

Tạo

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

Đọc

GET /{ig-user-id}/tags

Trả về danh sách các đối tượng File phương tiện trên Instagram mà một Người dùng Instagram đã được người dùng Instagram khác gắn thẻ.

Các giới hạn

Hệ thống sẽ không trả về các đối tượng riêng tư của File phương tiện trên Instagram.

Yêu cầu

LoạiMô tả

Mã truy cập

Người dùng

Tính năng

Không áp dụng.

Quyền

instagram_basic
instagram_manage_comments
pages_read_engagement

pages_show_list


Nếu mã này là của Người dùng được cấp vai trò trên Trang qua Trình quản lý kinh doanh, bạn cũng cần phải có một trong các quyền sau đây: ads_management, business_management hoặc pages_read_engagement.

Tác vụ

Người dùng ứng dụng phải có khả năng thực hiện các Tác vụ thích hợp trên Trang dựa vào Quyền mà ứng dụng yêu cầu.

Cú pháp yêu cầu

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

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

Thêm các thông số chuỗi truy vấn sau đây vào yêu cầu.

KhóaGiá trị

access_token
Bắt buộc
Chuỗi

Mã truy cập người dùng Instagram 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 và Cạnh mà bạn muốn có trong phản hồi, được phân tách bằng dấu phẩy. Nếu bỏ qua, các trường mặc định sẽ được trả về.

Trường

Hãy sử dụng thông số chuỗi truy vấn fields để chỉ định các trường thông tin mà bạn muốn có trong bất kỳ đối tượng File phương tiện trên Instagram nào được trả về.

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.

Cạnh

Hãy sử dụng thông số chuỗi truy vấn fields để chỉ định các Cạnh mà bạn muốn có trong bất kỳ đối tượng File phương tiện trên Instagram nào được trả về.

Phản hồi

Đối tượng ở định dạng JSON chứa các đối tượng File phương tiện trên Instagram.

{
  "{field}":"{value}",
  ...
}

Phân trang

Cạnh này hỗ trợ tính năng phân trang theo vị trí con trỏ. Vì vậy, 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 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ề.

Yêu cầu mẫu

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

Phản hồi mẫu

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

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