
API Đồ thị phiên bản 26.0 và API Marketing phiên bản 26.0 có các tính năng mới, tính năng ngừng hoạt động và thay đổi quan trọng. Hãy xem phần thông tin nổi bật bên dưới và truy cập nhật ký thay đổi của phiên bản 26.0 để xem danh sách đầy đủ các thay đổi và thông tin chi tiết.
advantage_audience thành 1 hoặc 0. Các thiết lập mặc định hoặc mở rộng sẽ tiếp tục lấy giá trị mặc định là 1. Thay đổi đối với nhóm quảng cáo hiện có sẽ không bị ảnh hưởng.applink_treatment được đặt thành web_only khi chiến dịch sử dụng vị trí chuyển đổi Trang web và ứng dụng. Hạn chế này áp dụng cho tất cả các phiên bản API Marketing từ ngày 27/10/2026.story sẽ tự động bị gỡ khỏi messenger_positions mà không có cảnh báo khi tạo hoặc cập nhật nhóm quảng cáo. Quyết định ngừng hỗ trợ này sẽ áp dụng cho tất cả phiên bản API Marketing (bao gồm cả lệnh gọi không có phiên bản) vào ngày 27/10/2026.daily_outcomes_curve, budget_guardrail và estimate_dau sẽ bị gỡ khỏi lệnh gọi đến phiên bản 26.0 từ ngày 29/07/2026, sau đó bị gỡ khỏi tất cả phiên bản được hỗ trợ còn lại từ ngày 27/10/2026. Không có API thay thế.Bắt đầu từ API Marketing phiên bản 26.0 vào ngày 29/07/2026, Quảng cáo trên Trạng thái WhatsApp sẽ hỗ trợ thêm các tính năng danh tính, nhắm mục tiêu, tối ưu hóa và nội dung.
wamo_whatsapp_identity_spec vào nội dung quảng cáo rõ ràng nếu muốn phân phối đến Trạng thái WhatsApp. Hệ thống không tự động đặt danh tính WhatsApp làm mặc định cho những bên thực hiện lệnh gọi này.user_age_unknown thì trường này sẽ mặc định là true, nghĩa là chiến dịch có thể tiếp cận những người không xác định độ tuổi trên WhatsApp.Xem tài liệu về nhắm mục tiêu theo vị trí quảng cáo và nhắm mục tiêu cơ bản để biết chi tiết.
Các trường daily_outcomes_curve, budget_guardrail, và estimate_dau sẽ bị gỡ khỏi phản hồi của điểm cuối Ước tính phân phối do dịch vụ hỗ trợ các giá trị này đã ngừng hoạt động. Bắt đầu từ API Đồ thị phiên bản 26.0 và API Marketing phiên bản 26.0 vào ngày 29/07/2026, các trường này sẽ không được trả về nữa. Thay đổi này sẽ áp dụng cho tất cả các phiên bản API Đồ thị và API Marketing được hỗ trợ còn lại vào ngày 27/10/2026. Không có API thay thế.
Nhà phát triển nên gỡ toàn bộ mã sử dụng hoặc tham chiếu đến các trường này trước ngày chính thức loại bỏ.
Các điểm cuối liên quan tiêu biểu bao gồm:
/{ad-account-id}/delivery_estimate - Số liệu ước tính về hoạt động phân phối của tài khoản quảng cáo/{adset-id}/delivery_estimate - Số liệu ước tính về hoạt động phân phối của nhóm quảng cáoDanh sách đầy đủ các trường và điểm cuối sẽ có trong nhật ký thay đổi của phiên bản 26.0.
Kể từ ngày 29/07/2026, các ứng dụng gọi những điểm cuối này trên API Đồ thị phiên bản 26.0 trở lên sẽ bị chặn. Các điểm cuối sẽ bị gỡ đối với tất cả phiên bản API Đồ thị còn lại vào ngày 27/10/2026. Sau đó, lệnh gọi sẽ trả về lỗi.
Trải nghiệm thanh toán ngay trên Facebook và Instagram cho Cửa hàng đã hoàn toàn ngừng hoạt động. Với API Quản lý đơn đặt hàng thương mại, các nền tảng bên thứ ba có thể liệt kê đơn đặt hàng, xem chi tiết đơn đặt hàng, quản lý lô hàng, xử lý yêu cầu hủy đơn đặt hàng, xử lý yêu cầu hoàn tiền và theo dõi yêu cầu trả lại hàng cho trải nghiệm thanh toán đó. Cơ sở hạ tầng đơn đặt hàng thương mại cơ bản sắp ngừng hoạt động nên những điểm cuối này sẽ không được dùng nữa.
Nhà phát triển nên dừng gọi các điểm cuối này và gỡ phần phụ thuộc. Không có API thay thế.
Các điểm cuối liên quan tiêu biểu bao gồm:
/{commerce-order-id} - Chi tiết đơn đặt hàng/{commerce-order-id}/items - Các mặt hàng trong đơn đặt hàng/{commerce-order-id}/payments - Order payments/{commerce-order-id}/payment_transaction_details - Chi tiết giao dịch thanh toán/{commerce-order-id}/refunds - Order refunds/{commerce-order-id}/shipments - Order shipments/{commerce-order-shipment-id}/items - Các mục trong chuyến hàng/{commerce-return-id} - Return details/{commerce-order-cancellation-id}/items - Vật phẩm hủy đơn đặt hàng/{page-id}/commerce_orders - Liệt kê đơn đặt hàng theo Trang/{commerce-merchant-settings-id}/commerce_orders - List orders by Commerce Merchant Settings/{commerce-merchant-settings-id}/commerce_returns - Liệt kê hàng trả lại theo Cài đặt người bán thương mại/{commerce-merchant-settings-id}/tax_settings - Tax settingsDanh sách đầy đủ 47 điểm cuối bị ảnh hưởng sẽ có trong nhật ký thay đổi của API Đồ thị phiên bản 26.0.
Trường reference_owner và matched_reference_owner trên AudioVisualReferenceMatch và ImageReferenceMatch (cùng với trường sending_rights_holder và receiving_rights_holder trên CopyrightOwnershipTransfer) sẽ ngừng hoạt động. Kể từ API Đồ thị phiên bản 26.0, các trường thay thế trả về loại RightsHolderOwner chuyên dụng sẽ có sẵn để thể hiện tốt hơn mô hình quyền sở hữu mà Công cụ bảo vệ bản quyền sử dụng, đồng thời các trường đã ngừng hoạt động sẽ không còn được trả về trong phản hồi từ phiên bản 26.0 trở lên.
Các trường thông tin không còn dùng nữa sẽ tiếp tục hoạt động trên phiên bản 25.0 trở xuống trong 2 năm sau khi phiên bản 26.0 ra mắt, sau đó sẽ bị gỡ. Nhà phát triển nên chuyển sang các trường thay thế trong khoảng thời gian 2 năm này.
Sử dụng các trường thay thế sau:
reference_owner_rh_owner thay vì reference_owner.matched_reference_owner_rh_owner thay vì matched_reference_owner.sending_rights_holder_owner thay vì sending_rights_holder.receiving_rights_holder_owner thay vì receiving_rights_holder.Các điểm cuối liên quan tiêu biểu bao gồm:
/{audio-visual-reference-match-id} - Chi tiết so khớp tham chiếu/{image-reference-match-id} - Chi tiết về kết quả khớp với hình ảnh tham chiếu/{copyright-ownership-transfer-id} - Ownership transfer detailsDanh sách trường đầy đủ sẽ có trong nhật ký thay đổi của API Đồ thị phiên bản 26.0.
Từ ngày 29/07/2026, API Đồ thị phiên bản 26.0 trở lên sẽ không còn hỗ trợ 5 hành vi giao thức cũ: pretty, debug, date_format, yêu cầu GET /?ids=... gốc và cách xử lý If-None-Match / ETag cũ.
Chúng tôi sẽ ngừng sử dụng những hành vi này để đơn giản hóa phản hồi của API Đồ thị và xử lý yêu cầu một cách nhất quán hơn.
Đối với API Đồ thị phiên bản 26.0 trở lên:
pretty được bỏ qua và phản hồi JSON sử dụng định dạng nhỏ gọn. Định dạng JSON trong các công cụ phía máy khách hoặc trong mã nguồn.debug bị bỏ qua và không có vỏ bọc phản hồi gỡ lỗi nào được thêm vào. Sử dụng các công cụ gỡ lỗi tiêu chuẩn. Điểm cuối debug_token không bị ảnh hưởng.date_format sẽ trả về lỗi thông số. Sử dụng định dạng ngày mặc định và chuyển đổi giá trị theo địa phương nếu cần.GET /?ids=... sẽ trả về lỗi thông số. Hãy sử dụng yêu cầu theo từng đối tượng hoặc cách tạo nhóm được hỗ trợ.If-None-Match được bỏ qua. Tiêu đề phản hồi ETag cũ và hành vi 304 Not Modified đã được gỡ, đồng thời yêu cầu trả về phản hồi đầy đủ.Kể từ ngày 27/10/2026, những thay đổi này sẽ áp dụng cho tất cả phiên bản API Đồ thị còn được hỗ trợ. Xem lại nhật ký yêu cầu thời gian chạy và nhật ký thay đổi của API Đồ thị phiên bản 26.0 để biết chi tiết về quá trình chuyển.
Bản nháp bài viết trên blog dành cho nhà phát triển. Bản phát hành mục tiêu: API Đồ thị phiên bản 26.0. Loại thay đổi: Ngừng hoạt động (90 ngày).
Tóm tắt
Đối với trang dùng Trải nghiệm Trang mới, 5 trường thông tin cũ dành cho Trang (current_location, genre, network, parking, start_info) và cài đặt Trang auto_publish_page_info_updates sẽ ngừng hoạt động kể từ API Đồ phiên bản 26.0. Các trường này không còn được duy trì và không nên được truy cập đối với các trang Trải nghiệm Trang mới.
Lịch trình
Những thay đổi
Trên phiên bản 26.0 trở lên, hệ thống sẽ trả về lỗi phiên bản khi bạn yêu cầu bất kỳ trường nào trong số 5 trường này trên trang dùng Trải nghiệm Trang mới. Cài đặt auto_publish_page_info_updates cũng không còn xuất hiện trong phản hồi cài đặt Trang. Trên các phiên bản cũ hơn, hành vi này không thay đổi cho đến khi hết khoảng thời gian chuyển 90 ngày, sau đó áp dụng tương tự cho tất cả các phiên bản.
Điểm cuối bị ảnh hưởng:
/{page-id}?fields=current_location/{page-id}?fields=genre/{page-id}?fields=network/{page-id}?fields=parking/{page-id}?fields=start_info/{page-id}?fields=settings - cài đặt auto_publish_page_info_updates bị gỡ khỏi danh sách cài đặt được trả vềĐiều nhà phát triển nên làm
auto_publish_page_info_updates khỏi yêu cầu Trang của bạn.Tài liệu tham khảo
Bắt đầu từ ngày 29/07/2026, với API Marketing phiên bản 26.0, thông số advantage_audience trong targeting_automation sẽ tự động được đặt thành 1 theo mặc định đối với cách thiết lập đối tượng hoàn toàn mặc định hoặc mở rộng. Đối với cách thiết lập đối tượng bị giới hạn, nhà phát triển phải đặt rõ advantage_audience thành 1 hoặc 0 đối với các chiến dịch thuộc hạng mục quảng cáo đặc biệt là Nhà ở, Việc làm hoặc Sản phẩm và dịch vụ tài chính.
Hành vi này chỉ áp dụng khi tạo nhóm quảng cáo mới. Việc cập nhật nhóm quảng cáo hiện có sẽ không thể hiện hành vi này trên bất kỳ phiên bản API nào.
Đây chính là hành vi mà chúng tôi đã giới thiệu cho các chiến dịch không thuộc Hạng mục quảng cáo đặc biệt trong API Marketing phiên bản 23.0. Hãy xem tài liệu khắc phục sự cố về Đối tượng Advantage+ để biết chi tiết.
Các điểm cuối API sau bị ảnh hưởng:
/{ad-account-id}/adsets/{adset-id}/{adset-id}/copiesKể từ API Marketing phiên bản 26.0 ngày 29/07/2026, vị trí quảng cáo Bảng feed Khám phá Instagram sẽ không còn nữa. Quảng cáo sẽ không còn phân phối đến Khám phá nữa và khoản chi tiêu cho chiến dịch sẽ tự động chuyển đến các vị trí quảng cáo đủ điều kiện khác.
Nếu bạn cố tạo hoặc cập nhật nhóm quảng cáo chỉ định vị trí quảng cáo Khám phá, hệ thống sẽ trả về lỗi. Nhà phát triển nên gỡ phần Khám phá khỏi cấu hình vị trí quảng cáo và sử dụng các vị trí quảng cáo đủ điều kiện khác.
Các điểm cuối sau bị ảnh hưởng:
/act_{ad-account-id}/adsets/{ad-set-id}Bắt đầu từ ngày 29/07/2026, với API Marketing phiên bản 26.0, nhà phát triển sẽ không còn có thể đính kèm nội dung quảng cáo có applink_treatment được đặt thành web_only vào quảng cáo trong chiến dịch sử dụng vị trí chuyển đổi Trang web và ứng dụng. Điều này ảnh hưởng đến quy trình tạo và cập nhật quảng cáo thông qua POST /act_{ad-account-id}/ads và POST /{ad-id}.
Điểm cuối Nội dung quảng cáo không thay đổi, nhưng POST /act_{ad-account-id}/adcreatives là nơi đặt cấu hình giá trị applink_treatment. Nhà phát triển nên xem lại tiện ích tích hợp cho applink_treatment=web_only và dùng lựa chọn đích đến tự động hoặc đích đến thủ công tương thích khác cho chiến dịch Trang web và ứng dụng.
Vào ngày 27/10/2026, 90 ngày sau khi phát hành phiên bản 26.0, hạn chế này sẽ áp dụng cho tất cả các phiên bản API Marketing. Hãy xem tài liệu về Quảng cáo và Nội dung quảng cáo để biết thêm thông tin.
Bắt đầu từ API Marketing phiên bản 26.0 vào ngày 29/07/2026, giá trị story trong messenger_positions sẽ không còn hoạt động khi tạo hoặc cập nhật nhóm quảng cáo thông qua lệnh gọi đến phiên bản 26.0 trở lên.
Đối với những lệnh gọi này, story sẽ bị gỡ (không kèm cảnh báo) khỏi quy cách nhắm mục tiêu và sẽ không còn xuất hiện trong vị trí quảng cáo hiệu quả cho nhóm quảng cáo mới hoặc nhóm quảng cáo hiện có. Dữ liệu nhắm mục tiêu trước đây có thể tiếp tục bao gồm story khi được yêu cầu thông qua GET /{ad_set-id}?fields=targeting. Hệ thống sẽ không trả về lỗi cụ thể, nhưng có thể xảy ra lỗi xác thực vị trí quảng cáo tiêu chuẩn nếu cấu hình vị trí quảng cáo không hợp lệ sau khi gỡ story.
Các điểm cuối sau bị ảnh hưởng:
/act_{ad-account-id}/adsets/{ad_set-id}Nhà phát triển sử dụng vị trí quảng cáo thủ công nên gỡ story khỏi messenger_positions. Nếu đó là giá trị duy nhất, hãy gỡ toàn bộ trường messenger_positions và cân nhắc gỡ messenger khỏi publisher_platforms khi không có vị trí quảng cáo nào khác trên Messenger (chẳng hạn như marketing_messages) được sử dụng. Không cần thực hiện hành động nào cho Vị trí quảng cáo Advantage+.
Sự thay đổi chỉ dành cho API này không ảnh hưởng đến Trình quản lý quảng cáo. Lệnh gọi không có phiên bản và lệnh gọi đến các phiên bản trước phiên bản 26.0 sẽ không bị ảnh hưởng trong giai đoạn đầu. Vào ngày 27/10/2026, 90 ngày sau khi phát hành phiên bản 26.0, quyết định ngừng hỗ trợ sẽ áp dụng cho tất cả các phiên bản API Marketing, bao gồm cả lệnh gọi không có phiên bản.
Bắt đầu từ API Marketing phiên bản 26.0 vào ngày 29/07/2026, các thành phần cuộc thăm dò ý kiến sẽ không còn được hỗ trợ khi tạo hoặc cập nhật quảng cáo và nội dung quảng cáo. Trường poll_spec và giá trị "poll" cho trường type sẽ không còn xuất hiện trong interactive_components_spec.
Các yêu cầu tạo nội dung cuộc thăm dò ý kiến hoặc thay đổi quảng cáo để sử dụng nội dung cuộc thăm dò ý kiến sẽ bị từ chối. Bạn vẫn có thể cập nhật quảng cáo hiện có mà không thay đổi nội dung, chẳng hạn như thay đổi trạng thái, ngân sách hoặc lịch chạy.
Các điểm cuối sau bị ảnh hưởng:
Nhà phát triển nên gỡ các trường liên quan đến cuộc thăm dò ý kiến khỏi quy cách nội dung của họ và sử dụng nội dung không có thành phần cuộc thăm dò ý kiến. Lệnh gọi đến các phiên bản trước phiên bản 26.0 và lệnh gọi không có phiên bản sẽ không bị ảnh hưởng trong giai đoạn đầu.
Vào ngày 27/10/2026, 90 ngày sau khi phát hành phiên bản 26.0, quyết định ngừng hỗ trợ này sẽ áp dụng cho tất cả các phiên bản API Marketing.
Bản phát hành Meta Business SDK phiên bản 26 sẽ được ra mắt ngay sau khi phát hành Đồ thị API phiên bản 26. Bản phát hành này sẽ bao gồm bản nâng cấp phần phụ thuộc, tiện ích tích hợp Công cụ tạo thông số API Chuyển đổi, các tính năng API mới, cũng như việc ngừng sử dụng API Quản lý đơn đặt hàng thương mại và một số tính năng giao thức cũ.
Business SDK hiện được tích hợp với Công cụ tạo thông số API Chuyển đổi nguồn mở. Bạn có thể tận dụng tiện ích tích hợp mới này để cải thiện chất lượng của tiện ích tích hợp API Chuyển đổi. Tính năng chính: Tạo tự động (được kiểm soát bằng tùy chọn do nhà quảng cáo đặt) và cải thiện các thông số fbc, fbp, event_source_url, referrer_url, client_ip_address và chuẩn hóa/băm PII tự động cho các ngôn ngữ được hỗ trợ, xem thêm tại đây. API Quản lý đơn đặt hàng thương mại (47 điểm cuối) ngừng hoạt động hoàn toàn mà không có API thay thế. Vị trí quảng cáo Bảng feed Khám phá trên Instagram sẽ bị gỡ và trả về lỗi nếu được chỉ định. Vị trí quảng cáo trên Messenger Stories đã bị gỡ khỏi messenger_positions một cách thầm lặng. Quảng cáo trên Trạng thái WhatsApp có các tính năng mới, bao gồm thông số nhận dạng, thẻ quay vòng lên đến 10 thẻ và tối ưu hóa chuyển đổi ngoài trang web.
Theo lịch ngừng hoạt động sau 2 năm của SDK Nền tảng, vui lòng lưu ý các SDK sắp ngừng hoạt động và ngừng cung cấp sau đây:
Theo lịch lập phiên bản API Đồ thị của Facebook, vui lòng lưu ý các phiên bản sắp ngừng hoạt động sau đây:
Để tránh bị gián đoạn, hãy chuyển tất cả lệnh gọi sang phiên bản API mới nhất.
Đăng ký nhận thông tin mới hàng tháng của Meta for Developers.