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.
Thao tác này không được hỗ trợ.
GET /<IG_MEDIA_ID>
Lấy các trường và cạnh trong file phương tiện trên Instagram.
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 đó.@
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.permalink
- không dùng được trên ảnh trong album (đối tượng con).GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID> ?fields=<LIST_OF_FIELDS> &access_token=<ACCESS_TOKEN>
Phần giữ chỗ | Giá trị |
---|---|
| Phiên bản API. |
| Bắt buộc. ID của file phương tiện sẽ được đăng. |
Khóa | Phần giữ chỗ | Giá trị |
---|---|---|
|
| Bắt buộc. Mã truy cập dành cho người dùng của người dùng ứng dụng |
|
| 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. |
Bạn có thể đọc các trường công khai qua tính năng mở rộng trường.
Trường | Mô tả | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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. | ||||||||||||||||
| 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. | ||||||||||||||||
| Chú thích. Không bao gồm đối tượng con của album. Không bao gồm ký hiệu | ||||||||||||||||
| 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. | ||||||||||||||||
| Trả về các đối tượng
Nếu video vi phạm bản quyền, hệ thống sẽ trả về
| ||||||||||||||||
| ID file phương tiện. | ||||||||||||||||
| 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. | ||||||||||||||||
| Chỉ dành cho Thước phim. Khi giá trị là 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. | ||||||||||||||||
| 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 | ||||||||||||||||
| Giao diện đăng file phương tiện. Có thể là | ||||||||||||||||
| Loại file phương tiện. Có thể là | ||||||||||||||||
| URL của file phương tiện. Trường | ||||||||||||||||
| 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 | ||||||||||||||||
| URL vĩnh viễn của file phương tiện. | ||||||||||||||||
| Mã rút ngắn của file phương tiện. | ||||||||||||||||
| URL hình thu nhỏ của file phương tiện. Chỉ có trên file phương tiện | ||||||||||||||||
| Ngày tạo ở định dạng theo tiêu chuẩn ISO 8601, giờ UTC (mặc định là UTC ±00:00). | ||||||||||||||||
| Tên người dùng đã tạo file phương tiện. |
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ạnh | Mô tả |
---|---|
| 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. |
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. | |
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. | |
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 -X GET \
'https://graph.instagram.com/v21.0
/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'
{ "id": "17918920912340654", "media_type": "IMAGE", "media_url": "https://sconten...", "owner": { "id": "17841405309211844" }, "timestamp": "2019-09-26T22:36:43+0000" }
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.
Không hỗ trợ File phương tiện trên Instagram trong video trực tiếp.
Instagram API with Instagram Login | Instagram API with Facebook Login | |
---|---|---|
Access Tokens |
| |
Host URL |
|
|
Login Type | Business Login for Instagram | Facebook Login for Business |
Permissions |
|
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:
|
POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID> ?comment_enabled=<BOOL> &access_token=<ACCESS_TOKEN>
Phần giữ chỗ | Giá trị |
---|---|
| Phiên bản API. |
| Bắt buộc. ID File phương tiện trên Instagram. |
Khóa | Phần giữ chỗ | Giá trị |
---|---|---|
|
| Bắt buộc.Mã truy cập dành cho người dùng của người dùng ứng dụng. |
|
| Bắt buộc. Đặt là |
curl -i -X POST \
"https://graph.instagram.com/v21.0
/17918920912340654?comment_enabled=true&access_token=EAAOc..."
{ "success": true }
Thao tác này không được hỗ trợ.