Nền tảng Instagram

Bắt đầu

Tài liệu này giải thích cách gọi thành công API Đồ thị trên Instagram bằng ứng dụng của bạn, cũng như cách lấy các đối tượng file phương tiện 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. Chúng tôi giả định rằng bạn đã quen dùng API Đồ thị và phương thức Đăng nhập bằng Facebook, cũng như biết cách thực hiện lệnh gọi API REST. Nếu chưa có ứng dụng, bạn có thể dùng Trình khám phá API Đồ thị và bỏ qua bước 1 và bước 2.

Trước khi bạn bắt đầu

Bạn sẽ cần có quyền truy cập vào các mục sau:

1. Đặt cấu hình phương thức Đăng nhập bằng Facebook

Thêm sản phẩm Đăng nhập bằng Facebook vào ứng dụng của bạn trong Bảng điều khiển ứng dụng.

Bạn có thể giữ nguyên tất cả tùy chọn cài đặt theo mặc định. Nếu bạn đang triển khai phương thức Đăng nhập bằng Facebook theo cách thủ công (chúng tôi không khuyên dùng cách này), hãy nhập redirect_uri của bạn vào trường URI chuyển hướng OAuth hợp lệ. Bạn có thể để trống trường đó nếu định sử dụng một trong các SDK của chúng tôi.

2. Triển khai phương thức Đăng nhập bằng Facebook

Hãy làm theo tài liệu về phương thức Đăng nhập bằng Facebook của chúng tôi dành cho nền tảng của bạn và triển khai phương thức đó trong ứng dụng bạn có. Sau đó, thiết lập quá trình triển khai để yêu cầu các quyền sau:

3. Lấy mã truy cập người dùng

Sau khi bạn triển khai phương thức Đăng nhập bằng Facebook, hãy nhớ đăng nhập vào tài khoản Nhà phát triển trên Facebook rồi truy cập vào ứng dụng của bạn và kích hoạt phương thức đó. Lưu ý rằng tài khoản Nhà phát triển trên Facebook 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à bạn muốn truy vấn.

Sau khi bạn kích hoạt phương thức đó, hãy nhấp vào OK để cấp cho ứng dụng của bạn các quyền instagram_basic và pages_show_list.

API sẽ trả về mã truy cập dành cho Người dùng. Hãy chụp mã này để ứng dụng của bạn có thể dùng trong một vài truy vấn tiếp theo. Nếu bạn đang dùng Trình khám phá API Đồ thị, mã này sẽ tự động được chụp và hiển thị trong trường Mã truy cập để bạn tham khảo:

4. Lấy các Trang của người dùng

Hãy truy vấn điểm cuối GET /me/accounts (điểm cuối này sẽ chuyển đổi thành GET /{user-id}/accounts để thực hiện yêu cầu GET trên nút Người dùng Facebook dựa vào mã truy cập của bạn).

curl -i -X GET \
 "https://graph.facebook.com/v19.0/me/accounts?access_token={access-token}"

Truy vấn này sẽ trả về một tập hợp các Trang Facebook cho phép Người dùng Facebook hiện tại thực hiện các tác vụ MANAGE, CREATE_CONTENT, MODERATE hoặc ADVERTISE:

{
  "data": [
    {
      "access_token": "EAAJjmJ...",
      "category": "App Page",
      "category_list": [
        {
          "id": "2301",
          "name": "App Page"
        }
      ],
      "name": "Metricsaurus",
      "id": "134895793791914",  // capture the Page ID
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    }
  ]
}

Sau đó, chụp ID của Trang Facebook kết nối với tài khoản Instagram mà bạn muốn truy vấn. Lưu ý rằng người dùng ứng dụng có thể thực hiện các tác vụ trên nhiều trang. Do đó, cuối cùng bạn sẽ phải đưa ra logic có thể xác định đúng ID Trang cần chụp (hoặc thiết lập giao diện người dùng để người dùng ứng dụng có thể xác định đúng Trang cho bạn).

5. Lấy Tài khoản kinh doanh trên Instagram của Trang

Hãy sử dụng ID Trang mà bạn đã chụp để truy vấn điểm cuối GET /{page-id}?fields=instagram_business_account:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/134895793791914?fields=instagram_business_account&access_token={access-token}"

Truy vấn này sẽ trả về Người dùng Instagram – một Tài khoản kinh doanh hoặc Tài khoản người sáng tạo nội dung trên Instagram – đã kết nối với Trang Facebook.

{
  "instagram_business_account": {
    "id": "17841405822304914"  // Connected IG User ID
  },
  "id": "134895793791914"  // Facebook Page ID
}

Sau đó, chụp ID Người dùng Instagram.

6. Lấy các đối tượng file phương tiện của Tài khoản kinh doanh trên Instagram

Hãy sử dụng ID Người dùng Instagram mà bạn đã chụp để truy vấn điểm cuối GET /{ig-user-id}/media:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17841405822304914/media?access_token={access-token}"

Truy vấn này sẽ trả về ID của tất cả đối tượng File phương tiện trên Instagram của Người dùng Instagram đó:

{
  "data": [
    {
      "id": "17918195224117851"
    },
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUkdGRXA2eHNNTUs4T1ZAXNGFxQTAtd3U4QjBLd1B2NXRMM1NkcnhqRFdBcEUzSDVJZATFoLWtXMWZAGU2VrRTk2RHVtTVlDckI2NjN0UERFa2JrUk4yMW13",
      "after": "QVFIUmlwbnFsM3N2cV9lZAFdCa0hDeV9qMVliT0VuMmJyNENxZA180c0t6VjFQVEJaTE9XV085aU92OUFLNFB6Szd2amo5aV9rTlVBcnNlWmEtMzYxcE1HSFR3"
    }
  }
}

Nếu có thể thực hiện thành công truy vấn cuối cùng này, bạn sẽ thực hiện được các truy vấn thông qua bất kỳ điểm cuối nào của API Đồ thị trên Instagram. Bạn chỉ cần xem các hướng dẫn và tài liệu tham khảo của chúng tôi để tìm hiểu những việc có thể làm và những quyền cần đến của từng điểm cuối.

Các bước tiếp theo

  • Phát triển ứng dụng của bạn hơn nữa để ứng dụng có thể sử dụng thành công mọi điểm cuối cần thiết khác và theo dõi các quyền mà mỗi điểm cuối cần có
  • Hoàn tất quy trình Xét duyệt ứng dụng và yêu cầu phê duyệt tất cả các quyền cần thiết cho ứng dụng để người dùng ứng dụng có thể cấp các quyền đó khi ứng dụng của bạn ở Chế độ chính thức
  • Chuyển ứng dụng của bạn sang Chế độ chính thức và tiếp thị ứng dụng đó cho người dùng tiềm năng

Sau khi ứng dụng của bạn ở Chế độ chính thức, mọi Người dùng Facebook mà bạn đã cung cấp ứng dụng đều có thể truy cập vào dữ liệu 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, miễn là họ có một tài khoản Người dùng Facebook có thể thực hiện các Tác vụ trên Trang kết nối với Tài khoản kinh doanh hoặc Tài khoản người sáng tạo nội dung trên Instagram đó.