Người dùng Instagram

Biểu thị Tài khoản kinh doanh trên Instagram hoặc Tài khoản người sáng tạo nội dung trên Instagram.

Tạo

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

Đọc

GET /{ig-user-id}

Lấy các trường và cạnh trên Tài khoản kinh doanh hoặc Tài khoản người sáng tạo nội dung trên Instagram.

Yêu cầu

Loại	Mô tả
Mã truy cập	Người dùng.
Vai trò trong doanh nghiệp	Nếu bạn đang yêu cầu trường `shopping_product_tag_eligibility` để gắn thẻ sản phẩm, người dùng ứng dụng phải có vai trò quản trị viên trên Trình quản lý kinh doanh sở hữu Cửa hàng trên Instagram của Người dùng Instagram.
Cửa hàng trên Instagram	Nếu bạn đang yêu cầu trường `shopping_product_tag_eligibility` để gắn thẻ sản phẩm, Người dùng Instagram phải có Cửa hàng trên Instagram được phê duyệt với một danh mục sản phẩm chứa các sản phẩm.
Quyền	`instagram_basic` `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 cần có một trong những quyền sau đây: `ads_management` `business_management` Nếu đang yêu cầu trường `shopping_product_tag_eligibility` để gắn thẻ sản phẩm, bạn cũng sẽ cần có: `catalog_management` `instagram_shopping_tag_products`

Cú pháp yêu cầu

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

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

Phần giữ chỗ	Giá trị
`{api-version}`	Phiên bản API.
`{ig-user-id}`	Bắt buộc. ID người dùng 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`	`{fields}`	Danh sách các trường của Người dùng Instagram mà bạn muốn nhận được cho từng Người dùng Instagram trong tập kết quả. Danh sách này được phân tách bằng dấu phẩy.

Trường

Các trường công khai mà một cạnh có thể trả về thông qua tính năng mở rộng trường.

Tên trường	Mô tả
`biography` Công khai	Nội dung phần tiểu sử trên trang cá nhân.
`id` Công khai	ID người dùng trong ứng dụng.
`ig_id`	ID người dùng Instagram. Được sử dụng với API Instagram cũ, hiện không được dùng nữa. Thay vào đó, hãy sử dụng `id`.
`followers_count` Công khai	Tổng số người dùng Instagram đang theo dõi người dùng.
`follows_count`	Tổng số người dùng Instagram mà người dùng theo dõi.
`media_count` Công khai	Tổng số File phương tiện trên Instagram đã đăng của người dùng.
`name`	Tên trang cá nhân.
`profile_picture_url`	URL ảnh đại diện.
`shopping_product_tag_eligibility`	Trả về `true` nếu người dùng ứng dụng đã thiết lập Cửa hàng trên Instagram và vì thế mà đủ điều kiện gắn thẻ sản phẩm. Nếu không, hệ thống sẽ trả về `false`.
`username` Công khai	Tên người dùng trên trang cá nhân.
`website` Công khai	URL trang web trên một trang cá nhân.

Cạnh

Cạnh	Mô tả
`business_discovery`	Lấy dữ liệu về Người dùng Instagram khác của Tài khoản kinh doanh hoặc Tài khoản người sáng tạo nội dung trên Instagram.
`content_publishing_limit`	Biểu thị cách sử dụng giải pháp đăng nội dung hiện tại của Người dùng Instagram.
`insights`	Biểu thị số liệu tương tác xã hội của Người dùng Instagram.
`live_media`	Biểu thị tập hợp File phương tiện trên Instagram trong video trực tiếp của Người dùng Instagram.
`media`	Biểu thị tập hợp các File phương tiện trên Instagram của Người dùng Instagram.
`media_publish`	Đăng một Vùng chứa trên Instagram của Người dùng Instagram thuộc Tài khoản kinh doanh trên Instagram.
`mentions`	Tạo Bình luận trên Instagram cho một Bình luận trên Instagram hoặc File phương tiện trên Instagram trong chú thích mà một Người dùng Instagram đã được người dùng Instagram khác @nhắc đến.
`mentioned_comment`	Lấy 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.
`mentioned_media`	Lấy 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.
`recently_searched_hashtags`	Lấy các Hashtag trên Instagram mà một Người dùng Instagram đã tìm kiếm trong vòng 7 ngày qua.
`stories`	Biểu thị tập hợp các đối tượng File phương tiện trên Instagram trong tin của Người dùng Instagram.
`tags`	Biểu thị tập hợp 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ẻ.

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 -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Phản hồi

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

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