Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 6 tháng 9

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.

Kể từ ngày 03/06/2024, bạn có thể dùng trường boost_eligibility_info để xác định một cách thuận tiện và hiệu quả xem file phương tiện có đủ điều kiện được quảng cáo dưới dạng một quảng cáo hay không, đồng thời có thể sử dụng boost_ads_list để theo dõi thông tin quảng cáo trước đây trên Instagram có liên quan đến quảng cáo đó. Hãy xem blog để biết thêm thông tin. Chỉ hỗ trợ API Đồ thị 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).
  • 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.
  • API này chỉ trả về dữ liệu của file phương tiện do tài khoản công việc trên Instagram sở hữu. Bạn không thể dùng API này để lấy dữ liệu của file phương tiện do tài khoản cá nhân trên Instagram sở hữu.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_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_MEDIA_ID>

Bắt buộc. ID của file phương tiện sẽ được đăng.

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

<LIST_OF_FIELDS>

Danh sách được phân tách bằng dấu phẩy gồm các trường mà bạn muốn nhận được.

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ả

boost_ads_list

Cung cấp phần tổng quan về mọi thông tin quảng cáo trên Instagram liên quan đến file phương tiện tự nhiên. Phần này có cả ID quảng cáo tương đối và trạng thái phân phối quảng cáo. Chỉ hỗ trợ API Đồ thị trên Instagram.

boost_eligibility_info

Trường này cung cấp thông tin về điều kiện quảng cáo file phương tiện trên Instagram dưới dạng quảng cáo và thông tin chi tiết bổ sung nếu không đủ điều kiện. Chỉ hỗ trợ API Đồ thị trên Instagram.

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 (chỉ hỗ trợ API Đồ thị trên Instagram).

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.

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 hoặc phần mở rộng trường khác, trường like_count sẽ bị bỏ qua trong trường hợp 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. Chỉ hỗ trợ API Đồ thị trên Instagram.

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 ở định dạng theo tiêu chuẩn 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.

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. Chỉ hỗ trợ API Đồ thị 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. Chỉ hỗ trợ API Đồ thị trên Instagram.

cURL mẫu

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "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

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

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram 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_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

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
  • business_management

Cú pháp yêu cầu

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &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.

comment_enabled

<BOOL>

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

cURL mẫu

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "success": true
}

Xóa

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