Nhật ký thay đổi của nền tảng Instagram

Nhật ký thay đổi này đề cập đến những thay đổi đối với API Instagram.

Nhật ký thay đổi liên quan

03/10/2024

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.

02/10/2024

Media Insights

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:

User Insights

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

17/09/2024

Giá trị 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_commentsbusiness_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.

23/07/2024

Ra mắt API Instagram mới qua phương thức Đăng nhập bằng Instagram

Các thành phần của API Instagram mới này:

  • Trang Facebook sẽ không còn cần thiết nữa
  • URL lưu trữ cho lệnh gọi API là graph.instagram.com
  • Các quyền mới dành cho API này:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • Messenger API sẽ không còn được dùng để gửi tin nhắn trên Instagram nữa
  • Các ứng dụng mới sẽ thêm sản phẩm Instagram mới khi tạo ứng dụng trên Meta
  • Các ứng dụng hiện tại có thể thêm sản phẩm Instagram mới trong Bảng điều khiển ứng dụng

Tham khảo hướng dẫn chuyển của chúng tôi để tìm hiểu liệu API Instagram mới qua phương thức Đăng nhập bằng Instagram này có phù hợp với bạn hay không.

11/06/2024

Webhook bình luận trên Instagram

Áp dụng cho tất cả phiên bản.

Ngoài ad_idad_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.

21/05/2024

Instagram User Insights

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:

12/09/2023

Deprecation of Media and User Insights

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.

09/11/2022

Webhooks Instagram

Áp dụng cho tất cả phiên bản.

Hệ thống sẽ trả về ad_idad_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.

31/10

Reels - Thẻ sản phẩm

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

28/06/2022

Reels

Á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_typeREELS 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.

27/06/2022

Tài liệu về API Instagram cũ

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

20/06/2022

Gắn thẻ sản phẩm

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

27/05/2022

Mẫu mã sản phẩm

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

15/03/2022

Bài viết quay vòng

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

09/11/2021

Video trực tiếp

Á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:

  • một cạnh GET /ig-user/live_media mới có thể trả về File phương tiện trên Instagram trong video trực tiếp đang được người dùng ứng dụng phát tại thời điểm yêu cầu
  • trường 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ận
  • một trường live_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át

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

20/10/2021

Bình luận trên Instagram

Á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:

  • from – trả về đối tượng chứa IGSID (id) và tên người dùng (username) của người tạo bình luận.
  • 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).

Webhooks Instagram

Á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.idIGSID 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ận
  • media.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).

05/10/2021

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.

  • trườngmedia_product_type sẽ trả về FEED thay vì IGTV
  • trườngvideo_title sẽ không được trả về
  • trường commentsmentions của Webhooks Instagram hiện đã được hỗ trợ

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.

08/06/2021

Số lượt thích

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


Phân trang theo thời gian

Áp dụng cho phiên bản 11.0 trở lên.

Chúng tôi đã thêm các thông số sinceuntil vào điểm cuối GET /{ig-user-id}/media để hỗ trợ phân trang theo thời gian.

26/05/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, 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 đó.

Ngày 04/05/2021

Đã 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.

14/04/2021

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:

  • Đối với những tin do người dùng tại Nhật Bản tạo, số liệu replies hiện sẽ trả về giá trị 0.
  • Đối với những tin do người dùng bên ngoài Nhật Bản tạo, số liệu 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.

12/04/2021

Đã 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.

09/04/2021

16/03/2021

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

26/01/2021

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.

02/12/2020

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:

  • Đối với Tin do người dùng tại EEA tạo, số liệu replies hiện sẽ trả về giá trị 0.
  • Đối với Tin do người dùng bên ngoài EEA tạo, số liệu 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.

10/11/2020

  • Thông tin chi tiết về người dùng Instagram - Giờ đây, các giá trị 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.

05/05/2020

03/12/2019

  • Thông tin chi tiết - Để thống nhất hành vi của API với hành vi của ứng dụng Instagram, thông tin chi tiết về Người dùng Instagram hiện chỉ có sẵn cho Người dùng Instagram có 100 người theo dõi trở lên.

Ngày 13/08/2019

  • Khám phá doanh nghiệp - Giờ đây, bạn có thể dùng API Khám phá doanh nghiệp để lấy dữ liệu về các Tài khoản người sáng tạo nội dung khác trên Instagram.

22/05/2019

09/05/2019

  • Webhooks - Trường story_insights hiện yêu cầu quyền instagram_manage_insights thay vì instagram_manage_comments.

31/10/2018

  • API Tìm kiếm hashtag - Giờ đây, bạn có thể tìm kiếm file phương tiện được gắn thẻ bằng những hashtag cụ thể thông qua API Tìm kiếm hashtag mới của chúng tôi. #spooky!

Ngày 23/10/2018

  • Cạnh /{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.

07/06/2018

  • Nút /{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.

01/05/2018

  • Xác minh doanh nghiệp - Để sử dụng API Đồ thị trên Instagram, tất cả ứng dụng phải trải qua quy trình Xác minh doanh nghiệp. Đây là một phần của quy trình Xét duyệt ứng dụng và hiện bắt buộc đối với tất cả điểm cuối API Đồ thị trên Instagram. Các ứng dụng đã được xét duyệt trước ngày 01/05/2018 đều phải xét duyệt lại trước ngày 01/08/2018. Nếu không, ứng dụng sẽ mất quyền truy cập vào API.

24/04/2018

  • Nút /{ig-comment-id}:
    • Đã thêm trường username mới.
    • Đối với các yêu cầu 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.
  • Nút /{ig-media-id}:
    • Đã thêm trường username mới.
    • Đối với các yêu cầu 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.

23/04/2018

  • 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

13/03/2018

  • API Đăng nội dung - Các đối tác beta hiện có thể dùng cạnh /{ig-user-id}/media để gắn thẻ vị tríngười dùng công khai trên Instagram khi đăng ảnh.

08/03/2018

  • Trường thông tin công khai - Trường 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.

22/02/2018

  • Trường thông tin công khai - Các nút /{ig-user-id}, /{ig-comment-id}/{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.

08/02/2018

  • API Đăng nội dung - Các đối tác beta hiện có thể thêm hashtag khi đăng ảnh qua cạnh /{ig-user-id}/media. #crazywildebeest FTW!