Tổng quan

API Đồ thị trên Instagram là tập hợp các điểm cuối API Đồ thị trên Facebook, cho phép các ứng dụng truy cập dữ liệu trong Tài khoản công việc trên Instagram (cả Tài khoản kinh doanh lẫn Tài khoản người sáng tạo nội dung). Nếu bạn chưa quen dùng API Đồ thị trên Facebook, vui lòng đọc tài liệu về API Đồ thị của chúng tôi trước khi tiếp tục.

URL cơ sở

Mọi điểm cuối đều có thể truy cập được thông qua máy chủ graph.facebook.com.

Người dùng ứng dụng

Tài khoản công việc trên Instagram được truy cập gián tiếp thông qua tài khoản Facebook, vì vậy người dùng ứng dụng của bạn phải có và sử dụng tài khoản Facebook khi đăng nhập vào ứng dụng. Ngoài ra, tài khoản Facebook phải có khả năng thực hiện các Tác vụ tương đương dành cho quản trị viên trên một Trang Facebook đã được kết nối với tài khoản Instagram mà người dùng đang cố gắng truy cập.

Những yêu cầu này áp dụng cho tất cả người dùng ứng dụng, ngay cả những người dùng có Vai trò trên ứng dụng của bạn hoặc Vai trò trong một Doanh nghiệp đã xác nhận ứng dụng.

Xác thực

Quá trình xác thực người dùng ứng dụng được xử lý thông qua mã truy cập. Người dùng có thể truy cập gián tiếp các tài khoản Công việc trên Instagram thông qua tài khoản Facebook. Do đó, tất cả các yêu cầu API đều phải bao gồm Mã truy cập dành cho người dùng Facebook của người dùng ứng dụng. Bạn có thể lấy mã truy cập từ người dùng ứng dụng bằng cách triển khai phương thức Đăng nhập bằng Facebook. Lưu ý rằng phương thức Đăng nhập bằng Facebook không hỗ trợ thông tin đăng nhập Instagram. Do đó, người dùng ứng dụng phải đăng nhập bằng tài khoản Facebook.

Ủy quyền

Quá trình ủy quyền điểm cuối được xử lý thông qua các quyền và tính năng. Trước khi ứng dụng của bạn có thể sử dụng một điểm cuối để truy cập vào dữ liệu trên Instagram của người dùng ứng dụng, bạn phải yêu cầu tất cả các quyền mà những điểm cuối đó yêu cầu từ người dùng ứng dụng trước đã. Sau đó, người dùng ứng dụng phải cấp những quyền đó cho ứng dụng của bạn. Sau khi được cấp quyền, bạn có thể truy vấn các điểm cuối để truy cập vào dữ liệu của người dùng.

Lưu ý rằng một quyền chỉ cho phép truy cập vào dữ liệu do người dùng đã cấp quyền đó tạo. Một vài điểm cuối cho phép ứng dụng truy cập vào dữ liệu không do người dùng ứng dụng tạo. Tuy nhiên, dữ liệu có thể truy cập sẽ bị hạn chế và ở chế độ công khai.

Bạn có thể yêu cầu quyền từ người dùng ứng dụng bằng cách triển khai phương thức Đăng nhập bằng Facebook. Người dùng ứng dụng có vai trò trên ứng dụng của bạn có thể cấp bất kỳ quyền nào được yêu cầu. Người dùng ứng dụng không có vai trò trên ứng dụng của bạn chỉ có thể cấp những quyền và tính năng đã được phê duyệt thông qua quy trình Xét duyệt ứng dụng.

API sử dụng các quyền và tính năng sau:

Hãy xem tài liệu tham khảo về điểm cuối của chúng tôi để xác định những quyền và tính năng mà ứng dụng của bạn sẽ cần yêu cầu từ người dùng ứng dụng.

Nhắn tin trên Instagram

Nếu định triển khai tính năng Nhắn tin trên Instagram trong Nền tảng Messenger, bạn sẽ cần có quyền instagram_manage_messages. Tìm hiểu thêm về tính năng Nhắn tin trên Instagram.

Cộng tác viên

Với tính năng Cộng tác trên Instagram, người dùng ứng dụng Instagram có thể cùng soạn thảo nội dung (tức là đăng file phương tiện) bằng các tài khoản khác (cộng tác viên).

Ngoài một vài trường hợp ngoại lệ, chỉ người dùng đăng file phương tiện mới có thể truy cập dữ liệu trên/về file phương tiện cùng được soạn thảo thông qua API; cộng tác viên không thể truy cập dữ liệu này thông qua API. Các trường hợp ngoại lệ duy nhất là khi tìm kiếm file phương tiện hoạt động hiệu quả nhất hoặc file phương tiện đăng gần đây được gắn thẻ hashtag cụ thể. Hãy xem phần Tìm kiếm hashtag.

Trang

Tài khoản công việc trên Instagram phải được kết nối với một Trang Facebook thì dữ liệu trên tài khoản đó mới có thể truy cập được thông qua API này. Sau khi được kết nối, bất kỳ Người dùng Facebook nào có thể thực hiện các Tác vụ trên Trang nêu trên đều có thể cấp cho ứng dụng của bạn một mã truy cập. Sau đó, mã này có thể được dùng trong các yêu cầu API.

Trong bài viết trợ giúp Thêm hoặc thay đổi Trang Facebook được kết nối với tài khoản công việc trên Instagram, chúng tôi sẽ giải thích cách kết nối một Trang Facebook với một Tài khoản công việc trên Instagram.

Tác vụ

Để một người dùng ứng dụng cấp quyền cho ứng dụng của bạn, người dùng ứng dụng đó phải có khả năng thực hiện các tác vụ trên Trang Facebook đã kết nối với tài khoản Instagram mà họ đang cố gắng truy cập. Người dùng ứng dụng có thể cấp quyền cho ứng dụng của bạn dựa trên các tác vụ mà họ có thể thực hiện như sau:

Quyền	`MANAGE`	`CREATE_CONTENT`	`MODERATE`	`ADVERTISE`	`ANALYZE`
instagram_basic	✔	✔	✔	✔	✔
instagram_content_publish	✔	✔
instagram_manage_comments	✔	✔	✔
instagram_manage_insights	✔	✔	✔	✔	✔

Bạn có thể xác định những tác vụ nào trên Trang mà người dùng ứng dụng có thể thực hiện bằng cách truy vấn điểm cuối GET /me/accounts bằng Mã truy cập dành cho người dùng của người dùng ứng dụng. Điểm cuối này sẽ trả về danh sách các Trang mà người dùng ứng dụng có thể thực hiện tác vụ trên đó, cũng như cho biết những tác vụ nào người dùng có thể thực hiện trên mỗi trang.

Hãy xem tài liệu tham khảo để biết những quyền mà mỗi điểm cuối yêu cầu. API này không hỗ trợ Người dùng hệ thống Trình quản lý kinh doanh hoặc người dùng hệ thống có vai trò Người đại diện để phát trực tiếp.

Đề cập đến các tác vụ

Nếu bạn cần thông báo cho người dùng ứng dụng về các tác vụ (và tác vụ nào cần phải có để sử dụng đúng cách ứng dụng của bạn), dưới đây là cách các tác vụ được đề cập đến trong những giao diện người dùng khác nhau của chúng tôi.

Trang truyền thống

Trang truyền thống gọi các tác vụ là vai trò. Người dùng ứng dụng có vai trò Quản trị viên trên một Trang có thể cấp bất kỳ quyền nào cho ứng dụng của bạn. Người dùng ứng dụng có vai trò khác có thể cấp các quyền như sau:

Vai trò	Quyền có thể cấp
Biên tập viên	instagram_basic instagram_content_publish
Người kiểm duyệt	instagram_basic instagram_manage_comments instagram_manage_insights
Nhà quảng cáo	instagram_basic instagram_manage_insights
Nhà phân tích	instagram_basic instagram_manage_insights

Trang trải nghiệm mới

Trang trải nghiệm mới gọi các tác vụ là Quyền truy cập trên Facebook hoặc Quyền truy cập vào công việc. Người dùng ứng dụng có Quyền truy cập trên Facebook trên một Trang có thể cấp bất kỳ quyền nào cho ứng dụng của bạn. Người dùng ứng dụng có Quyền truy cập vào công việc có thể cấp các quyền như sau:

Quyền truy cập vào công việc	Quyền có thể cấp
Quảng cáo	instagram_basic
Nội dung	instagram_basic instagram_content_publish
Thông tin chi tiết	instagram_basic instagram_manage_insights
Tin nhắn và Hoạt động cộng đồng	instagram_basic instagram_manage_comments

Để xác định liệu một Trang có đang sử dụng trải nghiệm mới hay không, hãy yêu cầu trường has_transitioned_to_new_page_experience. Giá trị này sẽ trả về true nếu Trang đó sử dụng trải nghiệm mới.

Xét duyệt ứng dụng

Ứng dụng của bạn phải hoàn thành quy trình Xét duyệt ứng dụng thì người dùng ứng dụng không có Vai trò trên ứng dụng hoặc Vai trò trong Doanh nghiệp đã xác nhận ứng dụng đó mới có thể sử dụng. Nếu ứng dụng của bạn chỉ được người dùng ứng dụng có Vai trò trên ứng dụng hoặc vai trò trong Doanh nghiệp sử dụng, bạn không cần hoàn thành quy trình Xét duyệt ứng dụng.

Nội dung gửi để Xét duyệt ứng dụng không cần phải thêm thông tin đăng nhập người dùng thử nghiệm Facebook nếu bạn đã triển khai phương thức Đăng nhập bằng Facebook và ứng dụng của bạn có sẵn công khai. Tuy nhiên, nếu người xét duyệt của chúng tôi cần đăng nhập vào tài khoản không phải Facebook để kích hoạt phương thức Đăng nhập bằng Facebook, bạn phải thêm thông tin đăng nhập tài khoản không phải Facebook vào nội dung gửi.

Ứng dụng riêng tư

Nếu người xét duyệt của chúng tôi không thể kiểm tra ứng dụng của bạn do ứng dụng nằm trong một mạng nội bộ riêng tư, không có giao diện người dùng hoặc chưa triển khai phương thức Đăng nhập bằng Facebook, bạn chỉ có thể yêu cầu phê duyệt cho những Quyền sau đây:

Xác minh doanh nghiệp

Bạn phải hoàn thành quy trình Xác minh doanh nghiệp nếu ứng dụng của bạn sẽ được người dùng ứng dụng không có Vai trò trên ứng dụng hoặc Vai trò trong Doanh nghiệp đã xác nhận ứng dụng đó sử dụng.

Giới hạn tốc độ

Tất cả điểm cuối đều phải tuân thủ Giới hạn tốc độ cho trường hợp sử dụng của doanh nghiệp trên Instagram, ngoại trừ các điểm cuối Khám phá doanh nghiệp và Tìm kiếm hashtag. Các điểm cuối này phải tuân thủ Giới hạn tốc độ trên nền tảng.

Webhooks

Bạn có thể sử dụng Webhooks để thông báo cho bạn mỗi khi ai đó bình luận trên đối tượng file phương tiện của người dùng ứng dụng hoặc khi bất kỳ tin nào của người dùng ứng dụng hết hạn. Hãy xem tài liệu tham khảo về Webhooks của chúng tôi để tìm hiểu cách sử dụng Webhooks, sau đó thiết lập một webhook cho chủ đề Instagram và đăng ký các trường comments và story_insights.

Nhắn tin trên Instagram

Một số điểm cuối API Đồ thị trên Instagram được dùng kết hợp với điểm cuối Nền tảng Messenger để người dùng ứng dụng có thể tương tác với các tin nhắn trực tiếp được gửi đến tài khoản Công việc của họ trên Instagram. Hãy tham khảo tài liệu về tính năng Nhắn tin trên Instagram của Nền tảng Messenger để tìm hiểu cách truy cập vào các tin nhắn trong Tài khoản kinh doanh trên Instagram.