File phương tiện trên Instagram

Biểu thị album, ảnh hoặc video (video đã tải lên, video trực tiếp, video được tạo bằng ứng dụng Instagram TV, thước phim hoặc tin) trên Instagram.

Tạo

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

Đọc

GET /{ig-media-id}

Lấy các trườngcạnh trong file phương tiện trên Instagram.

Giới hạn

  • Các trường trả về giá trị ở dạng tổng hợp không bao gồm dữ liệu dựa trên quảng cáo. Ví dụ: comments_count sẽ tính số bình luận trên ảnh, chứ không tính số bình luận trên quảng cáo chứa ảnh đó.
  • Chú thích chỉ bao gồm ký hiệu @ khi người dùng ứng dụng cũng có thể thực hiện các tác vụ tương đương dành cho Quản trị viên trên ứng dụng.
  • Một số trường - chẳng hạn như permalink - không dùng được trên ảnh trong album (đối tượng con).
  • Bạn phải chia sẻ file phương tiện trên Instagram TV lên Instagram vào thời điểm đăng (có bật tùy chọn Đăng bản xem trước hoặc Chia sẻ bản xem trước lên Bảng feed) để mọi người có thể truy cập vào file phương tiện đó qua API.
  • Người dùng chỉ đọc được File phương tiện trên Instagram trong video trực tiếp khi File phương tiện đó đang được phát.

Yêu cầu

LoạiMô tả

Mã truy cập

Người dùng.

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

Cú pháp yêu cầu

GET https://graph.facebook.com/{api-version}/{ig-media-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-media-id}

Bắt buộc. ID File phương tiện trên Instagram.

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

KhóaPhầ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 mà bạn muốn nhận được, được phân tách bằng dấu phẩy.

Trường

Bạn có thể đọc các trường công khai qua tính năng mở rộng trường.

TrườngMô tả

caption
Công khai

Chú thích. Không bao gồm đối tượng con của album. Không bao gồm ký hiệu @ trừ khi người dùng ứng dụng có thể thực hiện các tác vụ tương đương dành cho quản trị viên trên Trang Facebook kết nối với tài khoản Instagram được dùng để tạo chú thích.

comments_count
Công khai

Số bình luận trên file phương tiện. Không bao gồm bình luận trên file phương tiện thuộc album và chú thích của file phương tiện đó. Bao gồm lượt phản hồi bình luận.

copyright_check_information.status

Trả về các đối tượng statusmatches_found

đối tượng statusMô tả

status

  • completed - quá trình phát hiện đã kết thúc
  • error - đã xảy ra lỗi trong quá trình phát hiện
  • in_progress - quá trình phát hiện đang diễn ra
  • not_started - quá trình phát hiện chưa bắt đầu

matches_found

Được đặt thành một trong những giá trị sau đây:

  • false nếu video không vi phạm bản quyền,
  • true nếu video vi phạm bản quyền

Nếu video vi phạm bản quyền, hệ thống sẽ trả về copyright_matches cùng với một mảng các đối tượng về tài liệu có bản quyền, thời điểm trường hợp vi phạm xảy ra trong video và những hành động được thực hiện để giảm thiểu trường hợp vi phạm.

đối tượng copyright_matchesMô tả

author

tác giả của video có bản quyền

content_title

tên của video có bản quyền

matched_segments

Một mảng đối tượng có các cặp khóa-giá trị sau đây: * duration_in_seconds - số giây nội dung vi phạm bản quyền * segment_type - AUDIO hoặc VIDEO * start_time_in_seconds - được đặt là thời gian bắt đầu của video

owner_copyright_policy

Các đối tượng được trả về gồm có:

  • name - Tên chính sách của chủ sở hữu bản quyền
  • actions - Một mảng các đối tượng action cùng với những bước giảm thiểu được thực hiện do chính sách của chủ sở hữu bản quyền xác định. Mảng này có thể bao gồm các bước giảm thiểu khác nhau cho vị trí khác nhau.

    • action - Hành động giảm thiểu được thực hiện đối với video vi phạm bản quyền. Các bước giảm thiểu được thực hiện cho mỗi quốc gia có thể khác nhau. Có thể là một trong những giá trị sau đây:
      • BLOCK - Video bị chặn đối với đối tượng nêu trong mảng geos
      • MUTE - Video bị tắt tiếng đối với đối tượng nêu trong mảng geos

id
Công khai

ID file phương tiện.

ig_id
Công khai

ID file phương tiện trên 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.

is_comment_enabled

Cho biết bình luận được bật hay bị tắt. Không bao gồm đối tượng con của album.

is_shared_to_feed
Công khai

Chỉ dành cho Thước phim. Khi giá trị là true, thước phim sẽ hiển thị trong cả tab Bảng feed lẫn tab Reels. Khi giá trị là false, thước phim chỉ có thể hiển thị trong tab Reels.

Không có giá trị nào xác định liệu thước phim có thực sự hiển thị trong tab Reels hay không vì thước phim đó có thể không đủ điều kiện hoặc không được thuật toán của chúng tôi chọn. Hãy xem phần quy cách thước phim để biết tiêu chí đủ điều kiện.

like_count

Số lượt thích trên file phương tiện, bao gồm lượt phản hồi bình luận. Không bao gồm lượt thích trên file phương tiện thuộc album và lượt thích trên bài viết quảng cáo được tạo từ file phương tiện đó.


Nếu được truy vấn gián tiếp thông qua một điểm cuối khác hoặc tính năng mở rộng trường:


  • Các lệnh gọi v10.0 trở xuống: Giá trị là 0 nếu chủ sở hữu file phương tiện đã ẩn số lượt thích.
  • Các lệnh gọi v11 trở lên: Không có trường like_count nếu chủ sở hữu file phương tiện đã ẩn số lượt thích.

media_product_type
Công khai

Giao diện đăng file phương tiện. Có thể là AD, FEED, STORY hoặc REELS.

media_type
Công khai

Loại file phương tiện. Có thể là CAROUSEL_ALBUM, IMAGE hoặc VIDEO.

media_url
Công khai

URL của file phương tiện.

Trường media_url không có trong phản hồi nếu file phương tiện chứa tài liệu có bản quyền hoặc đã bị gắn cờ do vi phạm bản quyền. Ví dụ về tài liệu có bản quyền có thể bao gồm âm thanh trên thước phim.

owner
Công khai

ID của người dùng Instagram đã tạo file phương tiện. Chỉ được trả về nếu người thực hiện truy vấn (người dùng ứng dụng) cũng tạo file phương tiện. Nếu không, hệ thống sẽ trả về trường username.

permalink
Công khai

URL vĩnh viễn của file phương tiện.

shortcode
Công khai

Mã rút ngắn của file phương tiện.

thumbnail_url
Công khai

URL hình thu nhỏ của file phương tiện. Chỉ có trên file phương tiện VIDEO.

timestamp
Công khai

Ngày tạo theo định dạng ISO 8601, giờ UTC (mặc định là UTC ±00:00).

username
Công khai

Tên người dùng đã tạo file phương tiện.

video_title
Công khai

Không dùng nữa. Không có trong phản hồi.

Cạnh

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

CạnhMô tả

children
Công khai.

Biểu thị tập hợp các đối tượng File phương tiện trên Instagram trong File phương tiện trên Instagram của album.

collaborators

Biểu thị danh sách người dùng được thêm làm người cộng tác trên đối tượng File phương tiện trên Instagram.

comments

Biểu thị tập hợp các Bình luận trên Instagram cho một đối tượng File phương tiện trên Instagram.

insights

Biểu thị số liệu tương tác xã hội của đối tượng File phương tiện trên Instagram.

cURL mẫu

Yêu cầu

curl -X GET \
  'https://graph.facebook.com/v19.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Phản hồi

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Cập nhật

POST /{ig-media-id}

Bật hoặc tắt bình luận về một File phương tiện trên Instagram.

Giới hạn

File phương tiện trên Instagram trong video trực tiếp không được hỗ trợ.

Yêu cầu

LoạiMô tả

Mã truy cập

Người dùng.

Quyền

instagram_basic
instagram_manage_comments
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

Cú pháp yêu cầu

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

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

Phần giữ chỗGiá trị

{api-version}

Phiên bản API.

{ig-media-id}

Bắt buộc. ID File phương tiện trên Instagram.

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

KhóaPhần giữ chỗGiá trị

access_token

{access-token}

Bắt buộc.Mã truy cập người dùng của người dùng ứng dụng.

comment_enabled

{comment-enabled}

Bắt buộc. Đặt là true để bật bình luận hoặc false để tắt bình luận.

Ví dụ về cURL

Yêu cầu

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Phản hồi

{
  "success": true
}

Xóa

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