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

Trang này liệt kê ngày ngừng cung cấp và ngừng hoạt động của các phiên bản APIcác tính năng riêng lẻ trong Display & Video 360 API.

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

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

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

  • Phát hành: Phiên bản này không còn ở 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ẽ ngừng hoạt động và chúng tôi sẽ thông báo ngày kết thúc 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. Các tính năng bổ sung sẽ không còn đượ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ợ nữa. Các yêu cầu được gửi đến phiên bản này sẽ trả về lỗi.

Bảng này 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 cũng như ngày ngừng hoạt động và ngày ngừng cung cấp (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
v4 Ngày 27 tháng 3 năm 2025
v3 Ngày 31 tháng 10 năm 2023 Ngày 2 tháng 4 năm 2025 Ngày 7 tháng 10 năm 2025 Di chuyển từ phiên bản 3 sang phiên bản 4
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 nhà phát triển Google Ads để biết thông báo về những tính năng quan trọng sắp ngừng hoạt động.

Bảng này liệt kê tất cả các tính năng đã thông báo ngừng sử dụng có ảnh hưởng đến các phiên bản phát hành công khai, 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 kèm theo 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 Description
Quản lý tiêu chí nhắm mục tiêu của chiến dịch và đơn đặt hàng quảng cáo trong Display & Video 360 API và Tệp dữ liệu có cấu trúc Ngày 23 tháng 2 năm 2026

Vào ngày 23 tháng 2 năm 2026, Display & Video 360 sẽ ngừng cung cấp tiêu chí nhắm mục tiêu theo chiến dịch và đơn đặt hàng quảng cáo. Chúng tôi sẽ điều chỉnh Display & Video 360 API và Tệp dữ liệu có cấu trúc (SDF) cho phù hợp với thay đổi này. Trong Display & Video 360 API, một nhóm nhỏ các phương thức sẽ ngừng hoạt động và trả về lỗi nếu được gọi. Trong SDF, các cột tiêu chí nhắm mục tiêu trong tệp Đơn đặt hàng quảng cáoChiến dịch sẽ không còn được điền sẵn khi tải xuống và phải trống khi tải lên. Người dùng nên chỉ định tiêu chí nhắm mục tiêu trực tiếp cho mục hàng khi tạo mục hàng.

Các phương thức Display & Video 360 API sau đây sẽ trả về lỗi 404 nếu được gọi:

Các mục SDF Chiến dịch có giá trị được chỉ định cho các cột sau sẽ không tải lên được:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

Các mục SDF Lệnh chèn có giá trị được chỉ định cho các cột sau sẽ không tải lên được:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude
Khai báo xem các mục hàng có phân phát quảng cáo chính trị ở Liên minh Châu Âu hay không Ngày 8 tháng 9 năm 2025

Kể từ ngày 8 tháng 9 năm 2025, bạn sẽ phải khai báo xem một mục hàng có phân phát quảng cáo chính trị ở Liên minh Châu Âu hay không khi tạo một mục hàng mới bằng Display & Video 360 API hoặc SDF. Bạn có thể khai báo theo những cách sau:

Nếu nhà quảng cáo chính của bạn không chứa bất kỳ mục hàng nào phân phát quảng cáo chính trị ở Liên minh Châu Âu, thì bạn có thể khai báo ở cấp nhà quảng cáo bằng cách sử dụng trường containsEuPoliticalAds trong tài nguyên Advertiser của Display & Video 360 API. Nếu bạn đặt trường này thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, thì tất cả mục hàng mới thuộc nhà quảng cáo sẽ được chỉ định cùng một giá trị nếu không được chỉ định khác và tất cả mục hàng hiện có thuộc nhà quảng cáo sẽ được cập nhật để sử dụng cùng một giá trị nếu chưa được đặt. Bạn có thể cập nhật khai báo của mục hàng bất cứ lúc nào sau khi tạo bằng giao diện người dùng, API hoặc SDF.

Nếu bạn không thể khai báo ở cấp nhà quảng cáo hoặc đã khai báo rằng quảng cáo chính trị ở Liên minh Châu Âu có thể được phân phát trong nhà quảng cáo của bạn, hãy cập nhật chế độ tích hợp Display & Video 360 API và SDF trước ngày 8 tháng 9 năm 2025 để tránh bị gián đoạn dịch vụ:

Chế độ cài đặt Danh mục nội dung cho các mục riêng của YouTube và đối tác Ngày 12 tháng 6 năm 2025

Vào ngày 12 tháng 6 năm 2025, bạn sẽ không thể sửa đổi cấu hình danh mục nội dung cho từng mục hàng riêng lẻ trên YouTube và của đối tác trong quá trình cập nhật trải nghiệm về mức độ phù hợp với thương hiệu. Thay vào đó, chế độ cài đặt danh mục nội dung sẽ chỉ được kiểm soát ở cấp nhà quảng cáo. Để đáp ứng thay đổi này, chúng tôi sẽ thực hiện những thay đổi sau đối với API Display & Video 360 và Tệp dữ liệu có cấu trúc:

  • Trường contentCategory trong các đối tượng YoutubeAndPartnersSettings của tài nguyên YouTube và đối tác LineItem sẽ không được cập nhật nữa. Nội dung này sẽ bị xoá hoàn toàn vào một thời điểm khác.
  • Bạn sẽ không thể ghi vào cột TrueView Content Filter trong SDF Mục hàng nữa.
Để tránh bị gián đoạn dịch vụ, hãy làm như sau:
  • Truy xuất trường effectiveContentCategory thay cho trường contentCategory khi xem xét các mục hàng YouTube và đối tác trong API.
  • Ngừng sửa đổi cột TrueView Content Filter khi cập nhật các mục nhập mục hàng SDF. Để trống cột này khi tạo mục hàng mới.
Cập nhật ngân sách của mục hàng bằng tính năng tối ưu hoá đơn đặt hàng quảng cáo Ngày 12 tháng 6 năm 2025

Kể từ ngày 12 tháng 6 năm 2025, bạn sẽ không thể cập nhật chế độ cài đặt ngân sách cho các mục hàng có đơn đặt hàng gốc được đặt để tối ưu hoá bằng chiến lược giá thầu tự động.

Để tránh bị gián đoạn dịch vụ, hãy làm như sau:
Hạn chế về trang web đối với Tệp dữ liệu có cấu trúc Ngày 12 tháng 6 năm 2025

Kể từ ngày 12 tháng 6 năm 2025, chúng tôi sẽ xoá một quy định hạn chế hiện có đối với những URL được nhắm đến trong các mục SDF, quy định này hạn chế việc đưa các trang web mới hơn vào. Thay vào đó, SDF sẽ khớp với hành vi của API và giao diện người dùng, đồng thời cho phép nhắm đến các URL miễn là chúng được định dạng chính xác.

Điều này có liên quan đến cột Site Targeting - IncludeSite Targeting - Exclude trong tệp Đơn đặt hàng quảng cáoMục hàng.
Cột "Hệ số giá thầu" trong tệp dữ liệu có cấu trúc của mục hàng Ngày 1 tháng 5 năm 2025

Vào ngày 1 tháng 5 năm 2025, các mục trong tệp dữ liệu có cấu trúc Mục hàng cố gắng đặt cột "Hệ số giá thầu" sẽ không tạo hoặc cập nhật được tài nguyên khi tải tệp lên.

Yêu cầu nguồn khoảng không quảng cáo đối tác video cho mục hàng của chiến dịch Tạo nhu cầu trong tệp dữ liệu có cấu trúc Ngày 22 tháng 4 năm 2025

Kể từ ngày 22 tháng 4 năm 2025, bạn sẽ phải thêm giá trị "Đối tác video" vào cột TrueView Inventory Source Targeting của các mục nhập mục hàng có giá trị cột Type là "Tạo nhu cầu". Sau khi quy trình thực thi này bắt đầu, giá trị sẽ được điền sẵn cho các mục hàng hiện có và được đưa vào khi tải Tệp dữ liệu có cấu trúc mới xuống.

Để tránh bị gián đoạn dịch vụ, hãy làm như sau:

  • Cập nhật chế độ tích hợp để thêm giá trị "Đối tác video" vào tất cả các mục hàng của chiến dịch Tạo nhu cầu.
  • Cập nhật chế độ tích hợp để quản lý các nguồn khoảng không quảng cáo của chiến dịch Tạo nhu cầu ở cấp Nhóm quảng cáo bằng cách sử dụng các cột Nhóm quảng cáo SDF phiên bản 8.1 Demand Gen Inventory Source StrategyDemand Gen Enabled Inventory Sources.
Chiến dịch Video thúc đẩy hành động trong tệp dữ liệu có cấu trúc Ngày 22 tháng 4 năm 2025

Kể từ ngày 22 tháng 4 năm 2025, bạn sẽ không thể tạo Mục hàng cho chiến dịch Video thúc đẩy hành động bằng Tệp dữ liệu có cấu trúc nữa, vì các mục hàng này đang được nâng cấp thành chiến dịch Tạo nhu cầu. Các mục nhập Mục hàng cố gắng tải lên với giá trị cột Subtype là "Action" và giá trị cột Type là "TrueView" sẽ không thành công.

Để tránh bị gián đoạn dịch vụ, hãy cập nhật chế độ tích hợp để sử dụng chiến dịch Tạo nhu cầu thay vì chiến dịch Video thúc đẩy hành động.

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 nữa. Các yêu cầu firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch đặt giá trị trường membershipDurationDays thành 10.000 sẽ trả về lỗi 400. Đối tượng hiện có 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 thành viên hiện có. Thao tác này sẽ huỷ tất cả tư cách thành viên có thời hạn 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 quá trình 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 đối tượng hiện có thành 10.000.
  • Làm mới thành viên của đối tượng So khớp khách hàng hiện tại bằng cách sử dụng firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Thường xuyên làm mới thành viên đối tượng So khớp khách hàng để đảm bảo quy mô danh sách đối tượng của bạn không bị giảm đi một cách vô tình.

Trong phiên bản 4, thay đổi này được phản ánh trong tài nguyên FirstPartyAndPartnerAudience.

Thuật toán đặt giá thầu tuỳ chỉnh và hoạt động Floodlight không khớp Ngày 1 tháng 4 năm 2025

Vào ngày 1 tháng 4 năm 2025:

Để tránh bị gián đoạn dịch vụ, hãy cập nhật chế độ tích hợp của bạn thành:

  • Xác minh rằng các hoạt động Floodlight có liên quan được chỉ định cho một mục hàng trước hoặc cùng lúc với việc chỉ định một thuật toán đặt giá thầu tuỳ chỉnh.
  • Các thuật toán đặt giá thầu tuỳ chỉnh hiện có sẽ được huỷ chỉ định khỏi tất cả các mục hàng trước khi được cập nhật.

Các tính năng trước đây không còn được dùng nữa

Để đọc về những thông báo ngừng cung cấp ảnh hưởng đến các phiên bản ngừng hoạt động của Display & Video 360 API, hãy xem các thông báo ngừng cung cấp đã lưu trữ.