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 APItính năng riêng lẻ trong API Display & Video 360.

Ngày ngừng sử dụng và ngày ngừng hoạt động của 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 thường xuyên. Các bước này được xác định như sau:

  • 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 đang bị ngừng cung cấp và ngày kết thúc hỗ trợ (ngừng hoạt động) sẽ được thông báo. 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.
  • 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 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 và ngày ngừng sử dụng cũng như 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
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 dành cho nhà phát triển của Google Ads để biết thông báo về các tính năng quan trọng sắp ngừng sử dụ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ó tác động đến các phiên bản đang hoạt độ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 có liên quan:

Tính năng Ngày có hiệu lực ban đầu Mô tả
Quản lý việc nhắm mục tiêu chiến dịch và đơn đặt hàng quảng cáo trong API Display &Video 360 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 sử dụng tính năng nhắm mục tiêu chiến dịch và đơn đặt hàng quảng cáo. Chúng tôi sẽ thực hiện các thay đổi đối với API Display &Video 360 và Tệp dữ liệu có cấu trúc (SDF) để phù hợp với thay đổi này. Trong API Display &Video 360, một nhóm con 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 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 khi tải xuống và phải để trống khi tải lên. Người dùng nên chỉ định trực tiếp tính năng nhắm mục tiêu cho các mục hàng khi tạo mục hàng.

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

Mục SDF chiến dịch có giá trị được gán 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 đơn đặt hàng quảng cáo có giá trị được gán 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ục hàng mới bằng API Display &Video 360 hoặc SDF. Bạn có thể khai báo theo những cách sau:

Nếu nhà quảng cáo mẹ 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 API Display & Video 360. Nếu trường này được đặt thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, thì tất cả các mục hàng mới trong nhà quảng cáo sẽ được gán cùng một giá trị nếu không được chỉ định khác và tất cả các mục hàng hiện có trong nhà quảng cáo sẽ được cập nhật để sử dụng cùng một giá trị nếu chưa đặt giá trị. Bạn có thể cập nhật nội dung 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 API Display & Video 360 và tích hợp 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 hà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 của YouTube và đối tác ở cấp độ này như một phần của bản 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. Để phù hợp với thay đổi này, chúng tôi sẽ thực hiện các 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 LineItem của YouTube & đối tác sẽ không còn được cập nhật. Trường này sẽ bị xoá hoàn toàn vào một ngày sau đó.
  • Cột TrueView Content Filter trong SDF mục hàng sẽ không còn ghi được.
Để tránh bị gián đoạn dịch vụ:
  • Truy xuất trường effectiveContentCategory thay cho trường contentCategory khi xem xét các mục hàng của 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 SDF mục hàng. Để trống cột này khi tạo mục hàng mới.
Cập nhật ngân sách 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 quảng cáo mẹ được đặt để tối ưu hoá bằng chiến lược đặt giá thầu tự động.

Để tránh bị gián đoạn dịch vụ:
Quy định 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 các URL được nhắm mục tiêu 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ẽ so khớp hành vi của API và giao diện người dùng, đồng thời cho phép nhắm mục tiêu URL miễn là các URL đó được định dạng đúng cách.

Điều này có liên quan đến các 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ố nhân giá thầu" trong Tệp dữ liệu có cấu trúc 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 Mục hàng Tệp dữ liệu có cấu trúc cố gắng đặt cột "Hệ số nhân 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 của đối tác video cho các mục hàng 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 đưa giá trị "Đối tác video" vào cột TrueView Inventory Source Targeting của các mục hàng có giá trị cột Type là "Tạo nhu cầu". Sau khi quy định này bắt đầu có hiệu lực, giá trị sẽ được bổ sung dữ liệu cũ 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ụ:

  • Cập nhật quá trình tích hợp để đưa giá trị "Đối tác video" vào tất cả các mục hàng Tạo nhu cầu.
  • Cập nhật quá trình tích hợp để quản lý nguồn khoảng không quảng cáo 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

Vào 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 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 hàng cố gắng tải lên với giá trị cột Subtype là "Hành động" 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 quá trình 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ô hạn. firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch yêu cầu đặt giá trị trường membershipDurationDays thành 10.000 sẽ trả về lỗi 400. Các đố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 gói thành viên hiện có. Điều này sẽ làm hết hạn tất cả các gói thành viên cũ hơn 540 ngày.

Để tránh bị gián đoạn dịch vụ:

  • 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 hiện có thành 10.000.
  • Làm mới gói thành viên của đối tượng So khớp khách hàng hiện có bằng firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Thường xuyên làm mới gói 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 của bạn không bị giảm một cách vô tình.

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

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 quá trình tích hợp để:

  • Xác minh rằng các hoạt động Floodlight có liên quan được gán cho một mục hàng trước hoặc cùng lúc với việc gán 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ẽ bị huỷ gán khỏi tất cả các mục hàng trước khi cố gắng cập nhật.

Ngừng sử dụng tính năng trước

Để đọc thông tin về các tính năng đã thông báo ngừng sử dụng có tác động đến các phiên bản ngừng hoạt động của API Display & Video 360, hãy xem các tính năng ngừng sử dụng đã lưu trữ.