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.

Trong toàn bộ tài liệu, chúng tôi dùng "Người dùng Instagram" và "Tài khoản Instagram" thay thế cho nhau. Cả hai đều biểu thị tài khoản công việc trên Instagram của người dùng ứng dụng.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User 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_basic` `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` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

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.

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

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_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.
`<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`	`<LIST_OF_FIELDS>`	Danh sách được phân tách bằng dấu phẩy gồm 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ả.

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. Sẽ chỉ có sẵn một số trường để truy cập tài khoản Instagram dựa trên Trang.

Tên trường	Mô tả
`alt_text` Công khai	Văn bản mô tả cho hình ảnh để trợ năng.
`biography` Công khai	Nội dung phần tiểu sử trên trang cá nhân.
`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.
`has_profile_pic`	Cho biết liệu tài khoản công việc trên Instagram của người dùng ứng dụng có ảnh đại diện hay không.
`id` Công khai	ID người dùng trong ứng dụng. Có sẵn cho tài khoản Instagram dựa trên Trang.
`is_published`	Cho biết liệu tài khoản Instagram của người dùng ứng dụng có được đăng hay không. Có sẵn cho tài khoản Instagram dựa trên Trang.
`legacy_instagram_user_id`	ID Instagram của người dùng ứng dụng được tạo cho điểm cuối API Marketing v21.0 trở xuống. Có sẵn cho tài khoản Instagram dựa trên Trang.
`media_count` Công khai	Tổng số File phương tiện trên Instagram được đăng lên tài khoản của người dùng ứng dụng.
`name`	Tên trang cá nhân Instagram của người dùng ứng dụng.
`profile_picture_url`	URL ảnh đại diện trên Instagram của người dùng ứng dụng.
`collaborative_media_search`	Tìm kiếm file phương tiện cộng tác cụ thể theo ID. Truy cập qua tính năng mở rộng trường. Chỉ áp dụng cho API Instagram qua phương thức Đăng nhập bằng Facebook.
`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à nhờ đó 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 trang cá nhân Instagram của người dùng ứng dụng.
`website` Công khai	URL trang web của người dùng ứng dụng.

Cạnh

Cạnh	Mô tả
`agencies`	Danh sách các doanh nghiệp có thể quảng cáo cho tài khoản công việc trên Instagram này.
`authorized_adaccounts`	Tài khoản quảng cáo có thể quảng cáo cho tài khoản công việc trên Instagram này.
`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.
`connected_threads_user`	Đại diện cho tài khoản Threads được kết nối với tài khoả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.
`instagram_backed_threads_user`	Đại diện cho tài khoản Threads mà tài khoản Instagram hỗ trợ.
`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 có chú thích, trong đó 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 trong chú thích.
`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ẻ.
`upcoming_events`	Danh sách các sự kiện mà tài khoản công việc trên Instagram này tổ chức.
`collaboration_invites`	Biểu thị tập hợp các thuộc tính đối tượng `IG Media` (media_id, media_owner_username, caption, media_url) mà người dùng Instagram đã được mời cộng tác.
`collaborative_media`	Biểu thị tập hợp File phương tiện trên Instagram mà Người dùng Instagram là cộng tác viên được chấp nhận. Không bao gồm file phương tiện mà người dùng sở hữu trực tiếp. Chỉ áp dụng cho API Instagram qua phương thức Đăng nhập bằng Facebook.

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