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 của API phiên bản và các tính năng riêng lẻ trong Hiển thị và API Video 360.

Việc ngừng sử dụng và ngày ngừng cung cấp API cũng sẽ được thông báo vào Blog dành cho nhà phát triển Google Ads.

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

Hiển thị và Các phiên bản API Video 360 được phát hành, ngừng sử dụng và ngừng hoạt động thường xuyên. Các các bước đượ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 xem xét ổn định. Chúng tôi vẫn có thể phát hành các tính năng bổ sung cho phiên bản này.
• Ngừng sử dụng: Phiên bản sẽ ngừng hoạt động và không còn được hỗ trợ (ngừng hoạt động) ngày công bố. Người dùng phải di chuyển sang một phiên bản mới hơn trước khi dừng hoạt động ngày. Các tính năng bổ sung cho phiên bản này sẽ không được phát hành nữa.
• Sunset: Phiên bản này không còn được hỗ trợ. Yêu cầu được gửi đến phiên bản trả về lỗi.

Bảng dưới đây liệt kê tất cả các chiến dịch Hiển thị & Các phiên bản API Video 360, bản phát hành cũng như ngày ngừng sử dụng và ngày ngừng hoạt động (nếu có).

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

Theo dõi blog dành cho nhà phát triển Google Ads của chúng tôi để nhận các 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 đã được công bố về việc ngừng sử dụng, cung cấp thông tin ngày có hiệu lực 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 có 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	Từ ngày 25 tháng 3 năm 2023 đến đầu tháng 5 năm 2023, tính năng mở rộng tiêu chí nhắm mục tiêu sẽ được thay thế bằng tính năng tối ưu hoá tiêu chí nhắm mục tiêu. Các thay đổi liên quan đến chiến dịch Hiển thị và Cách hoạt động của API 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 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: 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 Mạng Hiển thị và 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 API DV360 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, yêu cầu được gửi đến những dịch vụ này hoặc đến các trường này sẽ trả về lỗi. Hành động được đề xuất: Ngay lập tức ngừng sử dụng trình kích hoạt thủ công để bắt đầu và ngừng phân phát mục hàng. Ngừng gửi yêu cầu đối với dịch vụ advertisers.manualTriggers. Cập nhật các trường flight.flightDateType và flight.triggerId cho tất cả các mục hàng bằng cách sử dụng điều kiện kích hoạt thủ công.
Loại ứng dụng đã cài đặt và thiết bị di động mới GoogleAudience	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 nữa. 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. Đ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 đã tạo có bao gồm các đối tượng không được 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 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, 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 các đố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 ngay lập tức sử dụng đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu mục hàng của mình 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 tại của mục hàng và đơn đặt hàng quảng cáo. Đọ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 của chúng tôi.
Các 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 nữa. 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. Đ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 đã tạo có bao gồm các đối tượng không được 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 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, 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 các đố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 ngay lập tức sử dụng đối tượng bị ảnh hưởng khi cập nhật tiêu chí nhắm mục tiêu mục hàng của mình 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 tại của mục hàng và đơn đặt hàng quảng cáo. Đọ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 của chúng tôi.
Giới hạn hạn mức API hiện có	Ngày 30 tháng 5 năm 2023	Kể 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 một cấu trúc hạn mức kết hợp với các lợi ích sau: Loại bỏ số yêu cầu mỗi ngày cho mỗi hạn mức dự án. Thiết lập một yêu cầu mỗi phút trên mỗi nhà quảng cáo cho mỗi hạn mức dự án đối với các phương thức đủ điều kiện. Các giới hạn mới này sẽ giúp bạn sử dụng API một cách linh hoạt hơn và thực hiện song song các yêu cầu của nhiều nhà quảng cáo. Thông tin chi tiết về thay đổi này được trình bày trong tài liệu về hạn mức hiện tại.
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 những quy tắc hạn chế thuộc các trường khác nhau. Ví dụ: Những 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 2 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 yêu cầu LIST của chúng tôi để biết thêm chi tiết về các hạn chế của 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ụ.
Khả năng lọc hoặc các yêu cầu danh sách thứ tự theo các 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 đượ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, những 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. Xoá tất cả bộ lọc và logic thứ tự theo 2 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ụ.
Khả năng lọc các yêu cầu advertisers.lineItems.list theo bốn 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 của 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 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 này 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 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ả, thì hệ thống 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ục hàng theo đơn đặt hàng quảng cáo bằng cách sử dụng phương thức mua dựa trên kết quả sẽ trả về lỗi 400 Vì tài nguyên đã lưu trữ không được đưa vào yêu cầu LIST theo mặc định, nên theo mặc định, tài nguyên bị ảnh hưởng sẽ không còn được trả về bằng phương thức advertisers.insertionOrders.list và advertisers.lineItems.list.
Trường publisherReviewStatuses trong tài nguyên về 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 các tài nguyên Creative.
Một số tiêu chí nhắm mục tiêu theo nội dung cho YouTube & Mục hàng của Đố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 thuộc tính đã xác định ngừng cung cấp các loại nhắm mục tiêu trên YouTube và Mục hàng của Đố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 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO Hệ thống sẽ tự động xoá các tiêu chí nhắm mục tiêu ngừng hoạt động khỏi tiêu chí nhắm mục tiêu mục hàng hiện tại. Để tránh bị 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 tài khoản YouTube và Mục hàng của Đối tác trước ngày ngừng cung cấp.
Đố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	Từ ngày 30 tháng 9 năm 2024, các nguồn tài nguyên FirstAndThirdPartyAudience trên Oracle sẽ ngừng hoạt động. Sau khi công cụ này ngừng hoạt động, những đối tượng này sẽ bị xoá khỏi mọi đối tượng kết hợp và đối tượng nhắm mục tiêu theo tài nguyên hiện có. Nếu một mục hàng chỉ nhắm mục tiêu đến các đối tượng đã ngừng cung cấp hoặc nhắm mục tiêu phủ định đến bất kỳ đối tượng nào đã ngừng hoạt động, thì quá trình cập nhật này sẽ tự động tạm dừng mục hàng đó. Để tránh bị 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 mục hàng hiện tại và đối tượng kết hợp trước ngày ngừng cung cấp.
Tính năng tối ưu hoá tiêu chí nhắm mục tiêu cho mục hàng cho một nhóm nhỏ 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, những tài nguyên LineItem sử dụng một số chiến lược giá thầu sẽ không còn tương thích với tính năng tối ưu hoá tiêu chí nhắm mục tiêu nữa. Với thay đổi này, LineItem tài nguyên 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 hay bidStrategy.performanceGoalAutoBid.performanceGoalType được đặt thành BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM sẽ được cập nhật thành 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 những mục hàng đang sử dụng các chiến lược giá thầu này chưa bật tính năng tối ưu hoá tiêu chí nhắm mục tiêu.
Bay càng sớm càng tốt Pacing cho đơn đặt hàng quảng cáo	Ngày 5 tháng 11 năm 2024	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 đơn đặt hàng quảng cáo pacing nữa. pacingType cho tất cả đơn đặt hàng quảng cáo 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 quảng cáo hiện có bằng PACING_TYPE_ASAP và PACING_PERIOD_FLIGHT.