Thông báo về việc không dùng nữa

Trang này liệt kê ngày ngừng sử dụng và ngày ngừng cung cấp cho các phiên bản API và các tính năng riêng lẻ trong API Display & Video 360.

Ngày ngừng sử dụng và ngừng cung cấp API cũng sẽ được thông báo trên blog dành cho nhà phát triển của Google Ads.

Phiên bản không dùng nữa

Các phiên bản Display & Video 360 API được phát hành, ngừng sử dụng và ngừng hoạt động thường xuyên. Các bước này được xác định như sau:

• Bản phát hành: Phiên bản thoát khỏi mọi trạng thái alpha hoặc beta và được coi là ổn định. Các tính năng bổ sung có thể vẫn được phát hành cho phiên bản này.
• Ngừng sử dụng: Phiên bản này sẽ ngừng hoạt động và ngày kết thúc hỗ trợ (ngừng hoạt động) được thông báo. Người dùng phải chuyển sang một phiên bản mới hơn trước ngày ngừng cung cấp. Các tính năng bổ sung sẽ không được phát hành cho phiên bản này nữa.
• Ngừng hoạt động: Phiên bản này không còn được hỗ trợ. Các yêu cầu đến phiên bản sẽ trả về lỗi.

Bảng dưới đây liệt kê tất cả các phiên bản API Display & Video 360 chính hiện có, ngày phát hành cũng như ngày ngừng sử dụng và ngừng hoạt động của các phiên bản đó (nếu được công bố).

Phiên bản API	Ngày phát hành	Ngày không dùng nữa	Ngày ngừng hoạt động	Hướng dẫn di chuyển
v3	Ngày 31 tháng 10 năm 2023
v2	Ngày 6 tháng 12 năm 2022	Ngày 15 tháng 2 năm 2024	Ngày 3 tháng 9 năm 2024	Chuyển từ phiên bản 2 sang phiên bản 3
v1	Ngày 9 tháng 3 năm 2020	Ngày 13 tháng 3 năm 2023	Ngày 14 tháng 9 năm 2023	Chuyển từ phiên bản 1 sang phiên bản 2

Ngừng sử dụng tính năng

Hãy theo dõi Blog dành cho nhà phát triển Google Ads để biết thông báo về việc ngừng sử dụng các tính năng quan trọng sắp tới.

Bảng dưới đây liệt kê tất cả các tính năng về việc ngừng sử dụng đã được công bố, cung cấp ngày có hiệu lực ban đầu và nội dung mô tả về việc ngừng sử dụng cùng với các hành động được đề xuất và đường liên kết đến tài liệu liên quan:

Tính năng	Ngày có hiệu lực ban đầu	Nội dung mô tả
Mở rộng phạm vi nhắm mục tiêu	Ngày 25 tháng 3 năm 2023	Thay thế tính năng mở rộng tiêu chí nhắm mục tiêu bằng tính năng tối ưu hoá tiêu chí nhắm mục tiêu, được triển khai từng bước từ ngày 25 tháng 3 năm 2023 đến đầu tháng 5 năm 2023. Những thay đổi liên quan đến hành vi của API Display & Video 360 và Tệp dữ liệu có cấu trúc cũng như các hành động được đề xuất đã được thông báo trong bài đăng trên blog.
Trình kích hoạt thủ công	Ngày 17 tháng 5 năm 2023	Dòng thời gian: Ngày 17 tháng 5 năm 2023: những mục hàng sử dụng trình kích hoạt thủ công sẽ ngừng phân phát trong Display & Video 360. Nếu bạn kích hoạt trình kích hoạt thủ công được liên kết với mục hàng đang hoạt động sau ngày này, thì mục hàng sẽ không phân phát quảng cáo. Ngày 1 tháng 8 năm 2023: Dịch vụ advertisers.manualTriggers trong API DV360 phiên bản 1 và phiên bản 2, LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER giá trị enum trong API DV360 phiên bản 1 sẽ ngừng hoạt động, đồng thời trường LineItemFlight.triggerId trong API DV360 phiên bản 1 sẽ ngừng hoạt động. Sau ngày này, các yêu cầu được gửi đến các dịch vụ này hoặc đến những trường này sẽ trả về lỗi. Hành động được đề xuất: Ngừng sử dụng trình kích hoạt thủ công ngay lập tức để bắt đầu và dừng phân phát mục hàng. Ngừng gửi yêu cầu đến dịch vụ advertisers.manualTriggers. Cập nhật các trường flight.flightDateType và flight.triggerId cho tất cả mục hàng bằng cách sử dụng trình kích hoạt thủ công.
Ứng dụng đã cài đặt và thiết bị di động mới GoogleAudience Loại	Ngày 20 tháng 5 năm 2023	Dòng thời gian: Ngày 20 tháng 5 năm 2023: Bạn sẽ không thể tiếp tục chỉ định GoogleAudience tài nguyên có GoogleAudienceType là GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS hoặc GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo. Yêu cầu chỉ định các đối tượng này vào tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Các yêu cầu này bao gồm các yêu cầu advertisers.lineItems.duplicate và advertisers.lineItems.generateDefault, nếu mục hàng đã tạo bao gồm các đối tượng không dùng nữa trong tiêu chí nhắm mục tiêu theo đối tượng. Ngày 8 tháng 6 năm 2023: Các đối tượng bị ảnh hưởng sẽ bị xoá khỏi mọi tiêu chí nhắm mục tiêu mục hàng và đơn đặt hàng quảng cáo, cũng như khỏi tất cả đối tượng kết hợp. Nếu một mục hàng không thể phân phát quảng cáo khi các đối tượng này bị xoá, thì mục hàng sẽ bị tạm dừng. Kể từ ngày này, bạn cũng sẽ không thể truy xuất những đối tượng này bằng dịch vụ googleAudiences nữa. Việc cần làm được đề xuất: Bạn nên ngừng sử dụng đối tượng bị ảnh hưởng ngay lập tức khi cập nhật tiêu chí nhắm mục tiêu mục hàng trong tương lai. Xoá tất cả đối tượng bị ảnh hưởng khỏi tiêu chí nhắm mục tiêu mục hàng và đơn đặt hàng quảng cáo hiện tại. Đọc về cách cập nhật tính năng nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu.
Dựa trên hoạt động và Giới hạn tần suất FirstAndThirdPartyAudience Các loại	Ngày 20 tháng 5 năm 2023	Dòng thời gian: Ngày 20 tháng 5 năm 2023: Bạn sẽ không thể tiếp tục chỉ định FirstAndThirdPartyAudience tài nguyên có AudienceType là ACTIVITY_BASED hoặc FREQUENCY_CAP cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hoặc đơn đặt hàng quảng cáo. Yêu cầu chỉ định các đối tượng này vào tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Các yêu cầu này bao gồm các yêu cầu advertisers.lineItems.duplicate và advertisers.lineItems.generateDefault, nếu mục hàng đã tạo bao gồm các đối tượng không dùng nữa trong tiêu chí nhắm mục tiêu theo đối tượng. Ngày 8 tháng 6 năm 2023: Các đối tượng bị ảnh hưởng sẽ bị xoá khỏi mọi tiêu chí nhắm mục tiêu mục hàng và đơn đặt hàng quảng cáo, cũng như khỏi tất cả đối tượng kết hợp. Nếu một mục hàng không thể phân phát quảng cáo khi các đối tượng này bị xoá, thì mục hàng sẽ bị tạm dừng. Kể từ ngày này, bạn cũng sẽ không thể truy xuất những đối tượng này bằng dịch vụ firstAndThirdPartyAudiences nữa. Việc cần làm được đề xuất: Bạn nên ngừng sử dụng đối tượng bị ảnh hưởng ngay lập tức khi cập nhật tiêu chí nhắm mục tiêu mục hàng trong tương lai. Xoá tất cả đối tượng bị ảnh hưởng khỏi tiêu chí nhắm mục tiêu mục hàng và đơn đặt hàng quảng cáo hiện tại. Đọc về cách cập nhật tính năng nhắm mục tiêu theo đối tượng trong hướng dẫn về Đối tượng mục tiêu.
Giới hạn hiện tại đối với hạn mức API	Ngày 30 tháng 5 năm 2023	Từ ngày 30 tháng 5 năm 2023, hạn mức sử dụng hiện tại sẽ được thay thế bằng cấu trúc hạn mức kết hợp nhằm thực hiện những việc sau: Loại bỏ hạn mức số yêu cầu mỗi ngày cho mỗi dự án. Thiết lập hạn mức số yêu cầu mỗi phút cho mỗi nhà quảng cáo trong mỗi dự án cho các phương pháp đủ điều kiện. Những giới hạn mới này sẽ cho phép việc sử dụng API linh hoạt hơn và cho phép thực hiện song song các yêu cầu giữa các nhà quảng cáo. Thông tin chi tiết về thay đổi này có trong tài liệu hiện tại về hạn mức của chúng tôi.
Việc sử dụng toán tử OR giữa các quy định hạn chế của các trường khác nhau trong bộ lọc LIST Ngày có hiệu lực ban đầu đã được cập nhật	Ngày 21 tháng 6 năm 2023	Từ ngày 21 tháng 6 năm 2023, LIST yêu cầu thông số filter sẽ không cho phép sử dụng toán tử logic OR giữa các trường hợp hạn chế của các trường khác nhau nữa. Ví dụ: thay vào đó, tài nguyên được xác định bằng chuỗi bộ lọc lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" phải được truy xuất bằng cách sử dụng hai yêu cầu LIST với chuỗi bộ lọc sau: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" Hãy tham khảo hướng dẫn cách lọc của chúng tôi về cách lọc yêu cầu LIST để biết thêm thông tin về các hạn chế đối với toán tử logic. Xem lại tham số truy vấn filter của tất cả lệnh gọi LIST hiện có và xác minh rằng các tham số đó đang sử dụng đúng toán tử logic OR trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.
Có thể lọc hoặc sắp xếp các yêu cầu danh sách theo trường budget.budget_segments.date_range.end_date và flight.dateRange.endDate Ngày có hiệu lực ban đầu đã được cập nhật	Ngày 21 tháng 6 năm 2023	Kể từ ngày 21 tháng 6 năm 2023, các trường budget.budget_segments.date_range.end_date và flight.dateRange.endDate sẽ không còn được chấp nhận trong các tham số truy vấn advertisers.insertionOrders.list và advertisers.lineItems.list filter và orderBy tương ứng. Sau ngày này, các yêu cầu sử dụng những trường này trong tham số truy vấn filter và orderBy sẽ trả về lỗi. Xoá tất cả bộ lọc và logic đặt hàng bằng hai trường này trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.
Có thể lọc các yêu cầu advertisers.lineItems.list theo 4 trường bổ sung	Ngày 21 tháng 6 năm 2023	Từ ngày 21 tháng 6 năm 2023, advertisers.lineItems.list sẽ không hỗ trợ tính năng lọc theo các trường sau đây nữa: flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages Hãy xoá tất cả logic bộ lọc bằng 4 trường này trước ngày 21 tháng 6 năm 2023 để tránh bị gián đoạn dịch vụ.
Mua dựa trên kết quả	Ngày 1 tháng 8 năm 2023	Từ ngày 1 tháng 8 năm 2023, các đơn đặt hàng quảng cáo sử dụng phương thức mua dựa trên kết quả, được xác định bằng giá trị trường billableOutcome là BILLABLE_OUTCOME_PAY_PER_CLICK hoặc BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, và các mục hàng con của các đơn đặt hàng đó sẽ được lưu trữ. Thay đổi này sẽ ảnh hưởng đến các yêu cầu sau: Việc cố gắng sử dụng advertisers.insertionOrders.create để tạo đơn đặt hàng quảng cáo bằng phương thức mua dựa trên kết quả sẽ trả về lỗi 400 Việc cố gắng sử dụng advertisers.lineItems.create, advertisers.lineItems.duplicate hoặc advertisers.lineItems.generateDefault để tạo một mục hàng trong đơn đặt hàng quảng cáo bằng phương thức mua dựa trên kết quả sẽ trả về lỗi 400 Do những tài nguyên được lưu trữ không được đưa vào các yêu cầu LIST theo mặc định, nên theo mặc định, các phương thức advertisers.insertionOrders.list và advertisers.lineItems.list sẽ không trả về những tài nguyên bị ảnh hưởng.