Nhật ký thay đổi này đề cập đến những thay đổi đối với API Instagram.
Quy trình tin nhắn chào mừng hiện đã dùng được cho API Instagram qua phương thức Đăng nhập bằng Instagram. Tìm hiểu thêm.
Applies to v21.0+. Will apply to all versions on January 8, 2025.
The video media metric video_views
will no longer be supported.
The following endpoints and metrics are affected:
GET /{ig-media-id}/insights
video_views
Applies to v21.0+. Will apply to all versions on January 8, 2025.
The email_contacts
, get_direction_clicks
, profile_views
, text_message_clicks
, website_clicks
, and phone_call_clicks
time series metrics will no longer be supported.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
email_contacts
get_direction_clicks
profile_views
text_message_clicks
website_clicks
phone_call_clicks
scope
mớiÁp dụng cho tất cả phiên bản.
Để đảm bảo tính nhất quán giữa giá trị scope
và tên quyền, chúng tôi sẽ ra mắt giá trị scope
mới dành cho API Instagram qua phương thức Đăng nhập bằng Instagram. Các giá trị scope
mới bao gồm:
instagram_business_basic
instagram_business_content_publish
instagram_business_manage_comments
instagram_business_manage_messages
Các giá trị này sẽ lần lượt thay thế giá trị business_basic
, business_content_publish
, business_manage_comments
và business_manage_messages
hiện có.
Lưu ý rằng các giá trị scope
cũ sẽ không được dùng nữa kể từ ngày 27/01/2025. Bạn cần cập nhật mã của mình trước ngày này để chức năng của ứng dụng không bị gián đoạn. Nếu không, ứng dụng của bạn sẽ không thể gọi điểm cuối của Instagram.
Sửa đổi: Đã chuyển ngày ngừng sử dụng từ 17/12/2024 sang 27/01/2025.
Các thành phần của API Instagram mới này:
graph.instagram.com
instagram_business_basic
instagram_business_content_publish
instagram_business_manage_comments
instagram_business_manage_messages
Áp dụng cho tất cả phiên bản.
Ngoài ad_id
và ad_title
, hệ thống sẽ trả về original_media_id
trong đối tượng media
thuộc đối tượng value
của trường comments
khi một người bình luận về bài viết được quảng cáo hoặc bài viết quảng cáo trên Instagram. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập Webhooks cho Instagram.
Applies to v20.0+. Will apply to all versions on August 19, 2024.
The last_14_days
, last_30_days
, last_90_days
and prev_month
timeframes will no longer be supported for the reached_audience_demographics
and engaged_audience_demographics
metrics.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
engaged_audience_demographics
reached_audience_demographics
Applies to v18.0+. Will apply to all versions on December 11, 2023.
Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
AUDIENCE_GENDER_AGE
AUDIENCE_LOCALE
AUDIENCE_COUNTRY
AUDIENCE_CITY
GET /{ig-media-id}/insights
CAROUSEL_ALBUM_IMPRESSIONS
CAROUSEL_ALBUM_REACH
CAROUSEL_ALBUM_ENGAGEMENT
CAROUSEL_ALBUM_SAVED
CAROUSEL_ALBUM_VIDEO_VIEWS
TAPS_FORWARD
TAPS_BACK
EXITS
ENGAGEMENT
Note: total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.
Áp dụng cho tất cả phiên bản.
Hệ thống sẽ trả về ad_id
và ad_title
trong đối tượng media
thuộc đối tượng value
của trường comments
khi một người bình luận về bài viết được quảng cáo hoặc bài viết quảng cáo trên Instagram.
Áp dụng cho tất cả phiên bản.
API Gắn thẻ sản phẩm trên Instagram dành cho Reels hiện đã được cung cấp. Bạn có thể gắn thẻ lên đến 30 sản phẩm khi đăng một thước phim.
Áp dụng cho tất cả các phiên bản.
Reels hiện đã được hỗ trợ. Nếu bạn muốn đăng một video dưới dạng thước phim, hãy đặt thông số media_type
là REELS
khi tạo vùng chứa cho bài viết có một file phương tiện. Hãy xem tài liệu tham khảo về POST /ig-user/media endpoint
để tìm hiểu những thông số bạn có thể dùng với thước phim cũng như các yêu cầu đối với video trên Reels.
Áp dụng cho tất cả phiên bản.
Tài liệu dành cho nhà phát triển API Instagram cũ đã bị gỡ và hiện chuyển hướng đến tài liệu dành cho nhà phát triển Nền tảng Instagram.
Áp dụng cho tất cả các phiên bản.
Giờ đây, bạn có thể tạo và quản lý Thẻ sản phẩm mua sắm trên Instagram trên file phương tiện đã đăng của Tài khoản kinh doanh trên Instagram. Hãy tham khảo hướng dẫn Gắn thẻ sản phẩm để tìm hiểu cách thực hiện.
Áp dụng cho tất cả phiên bản.
Đối với những đối tác tham gia chương trình beta Gắn thẻ sản phẩm, tất cả mẫu mã sản phẩm khớp với tiêu chí tìm kiếm của truy vấn hiện sẽ được trả về khi tìm kiếm danh mục sản phẩm.
Áp dụng cho tất cả phiên bản.
Giờ đây, bạn có thể sử dụng API Instagram để đăng bài viết chứa nhiều hình ảnh và video (bài viết quay vòng). Hãy tham khảo hướng dẫn Đăng nội dung để biết toàn bộ các bước đăng.
Nếu ứng dụng của bạn đã được phê duyệt các quyền cần có để đăng nội dung, ứng dụng đó không cần trải qua quy trình Xét duyệt ứng dụng một lần nữa mà vẫn tận dụng được chức năng này.
Áp dụng cho tất cả các phiên bản.
Giờ đây, bạn có thể sử dụng API Instagram để lấy File phương tiện trên Instagram trong video trực tiếp mà người dùng ứng dụng đang phát, lấy bình luận cho những video đó và sử dụng API Nhắn tin trên Instagram để gửi tin trả lời riêng tư (tin nhắn trực tiếp) cho tác giả của bình luận. Dưới đây là những thay đổi đã được thực hiện để có thể hỗ trợ chức năng này:
media
trong Bình luận trên Instagram hiện trả về đối tượng chứa cả ID (id
) và vị trí đăng (media_product_type
) của file phương tiện nhận được bình luậnlive_comments
mới của Webhooks Instagram có thể gửi thông báo chứa bình luận trực tiếp cho video trực tiếp của người dùng ứng dụng khi video đó đang được phátVui lòng tham khảo tài liệu về tin trả lời riêng tư của API Nhắn tin trên Instagram để biết cách gửi tin trả lời riêng tư cho người dùng đã bình luận về File phương tiện trên Instagram trong video trực tiếp của người dùng ứng dụng.
Áp dụng cho tất cả các phiên bản.
2 trường mới đã được thêm vào Bình luận trên Instagram:
parent_id
– trả về ID của Bình luận chính trên Instagram nếu Bình luận khác trên Instagram nhận được bình luận này (tức là phản hồi cho một bình luận khác).Áp dụng cho tất cả các phiên bản.
Trườngcomments
của Webhooks Instagram hiện có các thuộc tính sau trong đối tượng trường value
:
from.id
– IGSID của người dùng Instagram đã tạo bình luận.from.username
– Tên người dùng của người dùng Instagram đã tạo bình luậnmedia.id
– ID của File phương tiện trên Instagram nhận được bình luận.media.media_product_type
– Giao diện (vị trí đăng) của File phương tiện trên Instagram nhận được bình luận.parent_id
– ID của Bình luận chính trên Instagram nếu Bình luận khác trên Instagram nhận được bình luận này (tức là phản hồi cho một bình luận khác).Những thay đổi dưới đây áp dụng cho các video trên Instagram TV được tạo vào hoặc sau ngày 05/10/2021. Các video trên Instagram TV được tạo trước ngày này sẽ không thay đổi.
video_title
sẽ không được trả vềTừ ngày 03/01/2022, những thay đổi ở trên sẽ áp dụng cho tất cả phiên bản API và tất cả video trên Instagram TV, bất kể video được tạo vào ngày nào. Tức là kể từ ngày 03/01/2022, những ứng dụng dùng các phiên bản API cũ hơn sẽ có thể truy vấn video trên Instagram TV (trước đây chỉ hỗ trợ quyền đọc trong phiên bản 10.0 trở lên).
Kể từ phiên bản 14.0, trường video_title
sẽ không được hỗ trợ nữa và API sẽ báo lỗi nếu trường này được yêu cầu.
Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho tất cả các phiên bản kể từ ngày 07/09/2021.
Nếu truy vấn gián tiếp một File phương tiện trên Instagram thông qua điểm cuối khác hoặc phần mở rộng trường, trường like_count
sẽ không có trong phản hồi API nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Tuy nhiên, việc truy vấn trực tiếp File phương tiện trên Instagram (chỉ chủ sở hữu File phương tiện trên Instagram mới có thể thực hiện thao tác này) sẽ trả về số lượt thích thực tế, ngay cả khi số lượt thích của file phương tiện đó đã bị ẩn.
Áp dụng cho phiên bản 11.0 trở lên.
Chúng tôi đã thêm các thông số since
và until
vào điểm cuối GET /{ig-user-id}/media
để hỗ trợ phân trang theo thời gian.
Nếu truy vấn gián tiếp một File phương tiện trên Instagram thông qua điểm cuối khác, trường like_count hiện sẽ trả về 0
nếu người dùng ứng dụng không sở hữu file phương tiện và chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Việc truy vấn trực tiếp File phương tiện trên Instagram (chỉ chủ sở hữu File phương tiện trên Instagram mới có thể thực hiện việc này) sẽ trả về số lượt thích thực tế, ngay cả khi chủ sở hữu đã ẩn số lượt thích của file phương tiện đó.
Đã thực hiện sự thay đổi nhỏ đối với cách chúng tôi tính số liệu online_followers
cho Người dùng Instagram.
Các tương tác với File phương tiện trong tin trên Instagram do người dùng tại Nhật Bản thực hiện sẽ không được tính vào một vài số liệu replies
nữa:
replies
hiện sẽ trả về giá trị 0
.replies
sẽ trả về số phản hồi, không tính những phản hồi của người dùng Nhật Bản.Đã sửa một lỗi nhỏ với số liệu số người tiếp cận của File phương tiện trên Instagram trong tin.
status
trên Vùng chứa Instagram hiện trả về mã lỗi con nếu giá trị trường error_code
của vùng chứa là ERROR
.video_views
hiện hỗ trợ album và sẽ trả về tổng video_views
trên tất cả các video trong album thay cho 0
.File phương tiện trên IGTV hiện được hỗ trợ trong phiên bản 10.0 trở lên. Điều này áp dụng cho tất cả điểm cuối, ngoại trừ những điểm cuối dùng để đăng nội dung và dùng cho webhook. Để hỗ trợ sự thay đổi này, các trường media_product_type
và video_title
mới đã được thêm vào nút File phương tiện trên Instagram. File phương tiện trên IGTV phải được chia sẻ lên Instagram vào thời điểm đăng (khi đã 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) để có thể truy cập qua API.
Chương trình beta Đăng nội dung đã kết thúc và giờ đây, tất cả các nhà phát triển có thể đăng file phương tiện lên tài khoản Công việc trên Instagram. Hãy tham khảo hướng dẫn Đăng nội dung để biết chi tiết về cách sử dụng.
Theo Chỉ thị về quyền riêng tư điện tử của Liên minh châu Âu, các hoạt động tương tác với File phương tiện trên Instagram trong Tin liên quan đến hoạt động nhắn tin do người dùng tại Khu vực kinh tế châu Âu (EEA) thực hiện sau ngày 01/12/2020 sẽ không được tính vào một vài số liệu nữa:
replies
hiện sẽ trả về giá trị 0
.replies
sẽ trả về số tin trả lời, không tính những tin trả lời của người dùng tại EEA.Sự thay đổi này áp dụng cho tất cả phiên bản.
follower_count
sẽ thống nhất hơn với các giá trị tương ứng hiển thị trong ứng dụng Instagram. Ngoài ra, follower_count
hiện sẽ trả về dữ liệu tối đa là 30 ngày thay vì 2 năm. Sự thay đổi này áp dụng cho phiên bản 9.0 trở lên và sẽ áp dụng cho mọi phiên bản kể từ ngày 09/05/2021.timestamp
trên File phương tiện trên Instagram do các truy vấn Tìm kiếm hashtagGET /{ig-hashtag-id}/top_media
và GET /{ig-hashtag-id}/recent_media
trả về. Ví dụ: GET /{ig-hashtag-id}/top_media?fields=timestamp
.story_insights
hiện yêu cầu quyền instagram_manage_insights
thay vì instagram_manage_comments
.#spooky
!/{ig-media-id}/comments
- Các yêu cầu GET
được thực hiện bằng API phiên bản 3.1 trở xuống sẽ nhận được kết quả theo trình tự thời gian. Các yêu cầu được thực hiện bằng phiên bản 3.2 trở lên sẽ nhận được kết quả ngược trình tự thời gian. /{ig-media-id}
- Giờ đây, bạn có thể dùng tính năng mở rộng trường để lấy trường permalink
trên các đối tượng file phương tiện./{ig-comment-id}
:
username
mới.GET
, trường user
sẽ không được đưa vào phản hồi trừ khi Người dùng thực hiện yêu cầu sở hữu Bình luận; thay vào đó, chúng tôi sẽ trả về username
cho tất cả những người bình luận. Điều này cũng sẽ áp dụng cho các truy vấn về Bình luận được tạo thông qua các API khác, chẳng hạn như API Lượt nhắc./{ig-media-id}
:
username
mới.GET
, trường owner
sẽ không được đưa vào phản hồi trừ khi Người dùng thực hiện yêu cầu sở hữu đối tượng file phương tiện; thay vào đó, chúng tôi sẽ trả về username
cho tất cả những người bình luận. Điều này cũng áp dụng với các truy vấn về đối tượng file phương tiện được tạo thông qua các API khác, chẳng hạn như API Lượt nhắc.API Thông tin chi tiết - Thông tin chi tiết hiện sẽ bao gồm hoạt động quảng cáo được tạo qua API này, giao diện quảng cáo trên Facebook và tính năng Quảng cáo của Instagram. Điều này ảnh hưởng đến các số liệu sau:
impressions
reach
/{ig-user-id}/media
để gắn thẻ vị trí và người dùng công khai trên Instagram khi đăng ảnh.timestamp
trên nút /{ig-media-id}
hiện là trường thông tin công khai và có thể được trả về qua tính năng mở rộng trường./{ig-user-id}
, /{ig-comment-id}
và /{ig-media-id}
hiện sẽ trả về tất cả các trường thông tin công khai khi được truy cập qua một cạnh trong tính năng mở rộng trường. Hãy xem tài liệu tham khảo của từng nút để biết những trường nào ở chế độ công khai./{ig-user-id}/media
. #crazywildebeest
FTW!