File phương tiện của người dùng Instagram

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

Tạo

POST /{ig-user-id}/media

• Tạo một Vùng chứa trên Instagram cho hình ảnh, thẻ quay vòng, tin hoặc thước phim để dùng trong quy trình đăng bài viết. Hãy xem hướng dẫn Đăng nội dung để biết toàn bộ các bước đăng.

Các giới hạn

Giới hạn chung

• Vùng chứa sẽ hết hạn sau 24 giờ.
• Nếu Trang đã kết nối với tài khoản Công việc trên Instagram được nhắm đến yêu cầu Ủy quyền đăng trên Trang (PPA) thì bạn phải hoàn tất PPA. Nếu không, yêu cầu sẽ không thực hiện được.
• Nếu Trang đã kết nối với tài khoản Công việc trên Instagram được nhắm đến yêu cầu xác thực 2 yếu tố thì Người dùng Facebook cũng phải từng xác thực 2 yếu tố. Nếu không, yêu cầu sẽ không thực hiện được.
• Tính năng Đăng lên Instagram TV không được hỗ trợ.

Giới hạn trên Reels

• Thước phim không thể hiển thị trong album quay vòng.
• Hệ thống sẽ tuân theo cài đặt quyền riêng tư của tài khoản khi đăng. Ví dụ: nếu bạn bật cài đặt Cho phép remix, các thước phim đã đăng sẽ được bật tính năng remix khi đăng. Tuy nhiên, bạn có thể tắt tính năng remix trên các thước phim đã đăng theo cách thủ công thông qua ứng dụng Instagram.
• Tính năng gắn thẻ nhạc chỉ áp dụng cho âm thanh gốc.

Giới hạn của tin

• Tin sẽ hết hạn sau 24 giờ.
• Hỗ trợ URL video hoặc URL Thước phim, nhưng không hỗ trợ cả hai.
• Không hỗ trợ đăng nhãn dán (ví dụ: liên kết, cuộc thăm dò ý kiến, vị trí).

Yêu cầu

Quy cách hình ảnh

• Định dạng: JPEG
• Kích thước file: Tối đa 8MB.
• Tỷ lệ khung hình: Phải nằm trong khoảng từ 4:5 đến 1,91:1
• Chiều rộng tối thiểu: 320 (sẽ được tăng tỷ lệ lên mức tối thiểu nếu cần)
• Chiều rộng tối đa: 1440 (sẽ được giảm tỷ lệ xuống mức tối đa nếu cần)
• Chiều cao: Khác nhau tùy theo chiều rộng và tỷ lệ khung hình
• Không gian màu: sRGB. Các hình ảnh sử dụng không gian màu khác sẽ được chuyển đổi sang không gian màu sRGB.

Quy cách thước phim

Dưới đây là quy cách dành cho Thước phim:

• Vùng chứa: MOV hoặc MP4 (MPEG-4 Phần 14), không có danh sách chỉnh sửa, moov atom ở đầu file.
• Codec âm thanh: AAC, tốc độ mẫu tối đa 48khz, 1 hoặc 2 kênh (đơn âm hoặc âm thanh nổi).
• Codec video: HEVC hoặc H264, quét lũy tiến, GOP (nhóm ảnh) kín, lấy mẫu phụ sắc độ 4:2:0.
• Tốc độ khung hình: 23-60 khung hình/giây.
• Kích thước hình ảnh:

  • Số cột tối đa (điểm ảnh ngang): 1920
  • Tỷ lệ khung hình bắt buộc nằm trong khoảng từ 0,01:1 đến 10:1. Tuy nhiên, bạn nên sử dụng tỷ lệ 9:16 để tránh bị cắt hoặc có khoảng trống.
• Tốc độ bit của video: VBR, tối đa 25 Mb/giây
• Tốc độ bit của âm thanh: 128 kb/giây
• Thời lượng: Tối đa 15 phút, tối thiểu 3 giây
• Kích thước file: Tối đa 1GB

Dưới đây là quy cách dành cho ảnh bìa của Thước phim:

• Định dạng: JPEG
• Kích thước file: Tối đa 8MB
• Không gian màu: sRGB. Các hình ảnh sử dụng không gian màu khác sẽ được chuyển đổi sang sRGB.
• Tỷ lệ khung hình: Bạn nên sử dụng tỷ lệ 9:16 để tránh bị cắt hoặc có khoảng trống. Nếu tỷ lệ khung hình của ảnh gốc không phải là 9:16, chúng tôi sẽ cắt ảnh và sử dụng hình chữ nhật 9:16 ở giữa làm ảnh bìa cho thước phim. Nếu bạn chia sẻ thước phim lên bảng feed, chúng tôi sẽ cắt ảnh và sử dụng hình vuông 1:1 ở giữa làm ảnh bìa cho bài viết trên bảng feed.

Quy cách hình ảnh của tin

• Định dạng: JPEG
• Kích thước file: Tối đa 8MB.
• Tỷ lệ khung hình: Bạn nên sử dụng tỷ lệ 9:16 để tránh bị cắt hoặc có khoảng trống
• Không gian màu: sRGB. Các hình ảnh sử dụng không gian màu khác sẽ được chuyển đổi sang không gian màu sRGB

Quy cách video của tin

• Vùng chứa: MOV hoặc MP4 (MPEG-4 Phần 14), không có danh sách chỉnh sửa, moov atom ở đầu file.
• Codec âm thanh: AAC, tốc độ mẫu tối đa 48khz, 1 hoặc 2 kênh (đơn âm hoặc âm thanh nổi).
• Codec video: HEVC hoặc H264, quét lũy tiến, GOP (nhóm ảnh) kín, lấy mẫu phụ sắc độ 4:2:0.
• Tốc độ khung hình: 23-60 khung hình/giây.
• Kích thước hình ảnh:

  • Số cột tối đa (điểm ảnh ngang): 1920
  • Tỷ lệ khung hình bắt buộc nằm trong khoảng từ 0,01:1 đến 10:1. Tuy nhiên, bạn nên sử dụng tỷ lệ 9:16 để tránh bị cắt hoặc có khoảng trống
• Tốc độ bit của video: VBR, tối đa 25 Mb/giây
• Tốc độ bit của âm thanh: 128 kb/giây
• Thời lượng: Tối đa 60 giây, tối thiểu 3 giây
• Kích thước file: Tối đa 100MB

Cú pháp yêu cầu

Vùng chứa hình ảnh

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Vùng chứa thước phim

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Vùng chứa thẻ quay vòng

Chỉ vùng chứa thẻ quay vòng. Nếu bạn muốn tạo vùng chứa mục cho thẻ quay vòng, hãy tạo vùng chứa hình ảnh hoặc vùng chứa video (thước phim không được hỗ trợ). Hãy xem phần Bài viết quay vòng để biết toàn bộ các bước đăng.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Vùng chứa tin hình ảnh

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Vùng chứa tin video

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

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

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

Phản hồi

Đối tượng ở định dạng JSON chứa ID Vùng chứa trên Instagram mà bạn có thể dùng để đăng vùng chứa đó.

Quá trình tải video lên không đồng bộ. Vì vậy, việc nhận được ID vùng chứa không có nghĩa là đã tải lên thành công. Để xác minh rằng video đã được tải lên, hãy yêu cầu trường status_code trong Vùng chứa trên Instagram. Nếu giá trị là FINISHED, video đã được tải lên thành công.

{
  "id":"{ig-container-id}"
}

Yêu cầu mẫu

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Phản hồi mẫu

{
  "id": "17889455560051444"
}

Đọc

GET /{ig-user-id}/media

Lấy tất cả File phương tiện trên Instagram của một Người dùng Instagram.

Các giới hạn

• Trả về tối đa 10.000 file phương tiện đã tạo gần đây nhất.
• File phương tiện trong Tin trên Instagram không được hỗ trợ. Thay vào đó, hãy sử dụng điểm cuối GET /{ig-user-id}/stories.

Yêu cầu

Phân trang theo thời gian

Điểm cuối này hỗ trợ phân trang theo thời gian. Hãy thêm các thông số chuỗi truy vấn since và until với nhãn thời gian Unix hoặc giá trị dữ liệu strtotime để xác định khoảng thời gian.

Yêu cầu mẫu

GET graph.facebook.com/17841405822304914/media 

Phản hồi mẫu

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

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