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 hoạt động của các phiên bản API và các tính năng riêng lẻ trong API Display & Video 360.

Thông tin về việc ngừng sử dụng và ngày 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.

Ngừng sử dụng phiên bản

Các phiên bản API Display & Video 360 được phát hành, ngừng sử dụng và ngừng hoạt động theo định kỳ. 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 vẫn có thể được phát hành cho phiên bản này.
• Ngừng sử dụng: Phiên bản này sắp ngừng hoạt động và chúng tôi sẽ thông báo ngày ngừng hỗ trợ (ngừng cung cấp). Người dùng phải di chuyển sang phiên bản mới hơn trước ngày ngừng hoạt động. Chúng tôi sẽ không phát hành thêm tính năng cho phiên bản này nữa.
• Ngừng hoạt động: Phiên bản không còn được hỗ trợ. Các yêu cầu được gửi đến phiên bản này sẽ trả về lỗi.

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

Phiên bản API	Ngày phát hành	Ngày ngừng sử dụng	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	Di 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	Di 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 đã thông báo ngừng sử dụng, 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	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 dần từ ngày 25 tháng 3 năm 2023 đến đầu tháng 5 năm 2023. Chúng tôi đã thông báo về các thay đổi liên quan đối với 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 trong một bài đăng trên blog.
Điều kiện 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: Các 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 một điều kiện kích hoạt thủ công được liên kết với một 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 DV360 API phiên bản 1 và 2, giá trị enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER trong DV360 API phiên bản 1 và trường LineItemFlight.triggerId trong DV360 API phiên bản 1 sẽ ngừng hoạt động. Sau ngày này, các yêu cầu gửi đến các dịch vụ hoặc 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 để bắt đầu và dừng phân phát mục hàng ngay lập tức. 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 trình kích hoạt thủ công.
Các loại GoogleAudience Ứng dụng đã cài đặt và Thiết bị di động mớ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ể chỉ định tài nguyên GoogleAudience 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 xen kẽ. Các yêu cầu chỉ định những đối tượng này cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Điề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 được tạo sẽ 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: Những đối tượng bị ảnh hưởng sẽ bị xoá khỏi tất cả tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo xen kẽ, cũng như khỏi tất cả đối tượng kết hợp. Nếu 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. Nhiệm vụ được đề xuất: Bạn nên ngừng sử dụng ngay những đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu của dòng mục 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 hiện có của mục hàng và đơn đặt hàng quảng cáo. Hãy đọc bài viết về cách cập nhật tiêu chí nhắm mục tiêu theo đối tượng trong Hướng dẫn về đối tượng mục tiêu.
Loại FirstAndThirdPartyAudience dựa trên hoạt động và giới hạn tần suất	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ể chỉ định tài nguyên FirstAndThirdPartyAudience 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 xen kẽ. Các yêu cầu chỉ định những đối tượng này cho tiêu chí nhắm mục tiêu theo đối tượng của mục hàng sẽ trả về lỗi. Điề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 được tạo sẽ 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: Những đối tượng bị ảnh hưởng sẽ bị xoá khỏi tất cả tiêu chí nhắm mục tiêu của mục hàng và đơn đặt hàng quảng cáo xen kẽ, cũng như khỏi tất cả đối tượng kết hợp. Nếu 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. Nhiệm vụ được đề xuất: Bạn nên ngừng sử dụng ngay những đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu của dòng mục 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 hiện có của mục riêng và đơn đặt hàng quảng cáo. Hãy đọc bài viết về cách cập nhật tiêu chí 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 hạn mức API hiện tại	Ngày 30 tháng 5 năm 2023	Kể từ ngày 30 tháng 5 năm 2023, các giới hạn sử dụng hiện tại sẽ được thay thế bằng một cấu trúc hạn mức kết hợp như sau: Loại bỏ các yêu cầu mỗi ngày theo hạn mức 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 trên mỗi dự án đối với các phương thức đủ điều kiện. Những giới hạn mới này sẽ giúp bạn linh hoạt hơn trong việc sử dụng API và cho phép chạy song song các yêu cầu trên nhiều nhà quảng cáo. Bạn có thể xem thông tin chi tiết về thay đổi này trong tài liệu về hạn mức hiện tại.
Cách sử dụng toán tử OR giữa các quy tắc hạn chế của các trường khác nhau trong bộ lọc LIST Cập nhật Ngày có hiệu lực ban đầu	Ngày 21 tháng 6 năm 2023	Kể từ ngày 21 tháng 6 năm 2023, các tham số filter của yêu cầu LIST sẽ không còn cho phép sử dụng toán tử logic OR giữa các quy tắc hạn chế của các trường khác nhau. Ví dụ: các 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 hai yêu cầu LIST có các chuỗi bộ lọc sau: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" Tham khảo hướng dẫn cách lọc các yêu cầu LIST để biết thêm thông tin chi tiết về các quy định hạn chế đối với toán tử logic. Xem xét các 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 lệnh gọi đó đ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 Cập nhật Ngày có hiệu lực ban đầu	Ngày 21 tháng 6 năm 2023	Kể từ ngày 21 tháng 6 năm 2023, budget.budget_segments.date_range.end_date và flight.dateRange.endDate sẽ không còn là các trường được chấp nhận trong 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 các trường này trong tham số truy vấn filter và orderBy sẽ trả về lỗi. Hãy xoá tất cả bộ lọc và logic thứ tự bằng cách sử dụ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	Kể từ ngày 21 tháng 6 năm 2023, advertisers.lineItems.list sẽ không còn hỗ trợ lọc theo các trường sau: 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	Kể từ ngày 1 tháng 8 năm 2023, các đơn đặt hàng quảng cáo xen kẽ sử dụng chiến lượ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, cũng như các mục hàng con của đơ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: Nếu bạn cố gắng sử dụng advertisers.insertionOrders.create để tạo đơn đặt hàng quảng cáo bằng tính năng mua dựa trên kết quả, thì hệ thống sẽ trả về lỗi 400 Nếu bạn 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 xen kẽ bằng chiến lược mua dựa trên kết quả, thì hệ thống sẽ trả về lỗi 400 Theo mặc định, các tài nguyên đã lưu trữ không được đưa vào yêu cầu LIST. Do đó, các tài nguyên bị ảnh hưởng sẽ không còn được các phương thức advertisers.insertionOrders.list và advertisers.lineItems.list trả về theo mặc định.
Trường publisherReviewStatuses trong tài nguyên mẫu quảng cáo	Ngày 26 tháng 6 năm 2024	Kể từ ngày 26 tháng 6 năm 2024, trường publisherReviewStatuses sẽ ngừng hoạt động và sẽ trống khi truy xuất tài nguyên Creative.
Nhắm mục tiêu theo nội dung cho mục hàng của YouTube và đối tác	Ngày 30 tháng 9 năm 2024	Kể từ ngày 30 tháng 9 năm 2024, các giá trị sau đây cho các loại tiêu chí nhắm mục tiêu đã xác định sẽ ngừng hoạt động đối với mục YouTube và đối tác: TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO Các lựa chọn nhắm mục tiêu theo thời điểm ngừng hoạt động sẽ tự động bị xoá khỏi tiêu chí nhắm mục tiêu mục hàng hiện tại. Bạn vẫn có thể sử dụng các giá trị này trong tiêu chí nhắm mục tiêu ở cấp nhà quảng cáo. Để tránh gián đoạn dịch vụ, hãy xoá tiêu chí nhắm mục tiêu này khỏi mọi mục hàng YouTube và đối tác hiện có trước ngày ngừng hoạt động.
Đối tượng bên thứ nhất và bên thứ ba của Oracle	Ngày 30 tháng 9 năm 2024	Kể từ ngày 30 tháng 9 năm 2024, các nguồn tài nguyên FirstAndThirdPartyAudience của Oracle sẽ ngừng hoạt động. Khi ngừng hoạt động, những đối tượng này sẽ bị xoá khỏi mọi tiêu chí nhắm mục tiêu theo tài nguyên và đối tượng kết hợp hiện có. Nếu một mục hàng chỉ nhắm đến đối tượng ngừng hoạt động hoặc nhắm đến đối tượng ngừng hoạt động theo cách tiêu cực, thì nội dung cập nhật này sẽ tự động tạm dừng mục hàng đó. Để tránh gián đoạn dịch vụ, hãy xác định và xoá mọi đối tượng Oracle khỏi tiêu chí nhắm mục tiêu theo đối tượng của mục hàng hiện có và đối tượng kết hợp trước ngày ngừng hoạt động.
Tiêu chí nhắm mục tiêu được tối ưu hoá của mục hàng cho một số chiến lược giá thầu	Ngày 30 tháng 9 năm 2024	Kể từ ngày 30 tháng 9 năm 2024, các tài nguyên LineItem sử dụng một nhóm chiến lược giá thầu sẽ không còn tương thích với tính năng nhắm mục tiêu được tối ưu hoá. Với thay đổi này, các tài nguyên LineItem có targetingExpansion.enableOptimizedTargeting được đặt thành True và bidStrategy.maximizeSpendAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN hoặc BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED hoặc bidStrategy.performanceGoalAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM sẽ được cập nhật để đặt targetingExpansion.enableOptimizedTargeting thành False. Để tránh bị gián đoạn dịch vụ, hãy cập nhật và xác minh rằng các mục hàng sử dụng những chiến lược giá thầu này không bật tính năng tối ưu hoá tiêu chí nhắm mục tiêu.
Chạy ngay Pacing cho đơn đặt hàng quảng cáo	Ngày 5 tháng 11 năm 2024	Kể từ ngày 5 tháng 11 năm 2024, PACING_TYPE_ASAP sẽ không còn tương thích với PACING_PERIOD_FLIGHT khi đặt trường thứ tự chèn pacing. pacingType cho tất cả các đơn đặt hàng quảng cáo xen kẽ hiện có có cấu hình này sẽ được cập nhật thành PACING_TYPE_AHEAD. Để tránh bị gián đoạn dịch vụ, hãy cập nhật pacing của mọi đơn đặt hàng chèn hiện có bằng PACING_TYPE_ASAP và PACING_PERIOD_FLIGHT.
Thời hạn thành viên vô hạn cho đối tượng bên thứ nhất	Ngày 7 tháng 4 năm 2025	Kể từ ngày 7 tháng 4 năm 2025, tài nguyên FirstAndThirdPartyAudience sẽ không còn cho phép thời hạn thành viên đối tượng vô thời hạn. Các yêu cầu firstAndThirdPartyAudiences.create và firstAndThirdPartyAudiences.patch thiết lập giá trị trường membershipDurationDays thành 10.000 sẽ trả về lỗi 400. Đối tượng hiện tại có giá trị trường membershipDurationDays là 10.000 sẽ được cập nhật thành 540 và thời hạn thành viên mới sẽ được áp dụng hồi tố cho các gói thành viên hiện tại. Thao tác này sẽ làm hết hạn tất cả gói thành viên cũ hơn 540 ngày. Để tránh bị gián đoạn dịch vụ, hãy làm như sau: Xác minh rằng tính năng tích hợp của bạn không đặt giá trị trường membershipDurationDays của đối tượng mới hoặc hiện tại thành 10.000. Làm mới tư cách thành viên của các đối tượng So khớp khách hàng hiện tại bằng firstAndThirdPartyAudiences.editCustomerMatchMembers. Thường xuyên làm mới danh sách thành viên đối tượng So khớp khách hàng để đảm bảo rằng quy mô danh sách đối tượng không bị giảm đi do nhầm lẫn.