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 nhà phát triển 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 này 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 đang ngừng hoạt động và ngày ngừng hỗ trợ (ngừng hoạt động) đượ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 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 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
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ề 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 ảnh hưở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 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 Mô tả
Nielsen là nhà cung cấp bên thứ ba đo lường mức tăng thương hiệu Ngày 13 tháng 7 năm 2026

Kể từ ngày 13 tháng 7 năm 2026, bạn sẽ không thể chỉ định Nielsen làm nhà cung cấp bên thứ ba để đo lường mức tăng thương hiệu nữa. Để 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:

Việc sử dụng Nielsen làm nhà cung cấp mức tăng thương hiệu hiện tại sẽ bị xoá.

Để tránh bị gián đoạn dịch vụ, hãy xoá mọi chỉ định Nielsen làm nhà cung cấp mức tăng thương hiệu khỏi quá trình tích hợp của bạn.

Kế thừa tên và biểu trưng doanh nghiệp mặc định Ngày 13 tháng 7 năm 2026

Kể từ ngày 13 tháng 7 năm 2026, quảng cáo thích ứng trên YouTube sẽ bắt đầu hỗ trợ các thành phần tên và biểu trưng doanh nghiệp. Tất cả quảng cáo Tạo nhu cầu và quảng cáo thích ứng trên YouTube không có thành phần tên và biểu trưng doanh nghiệp sẽ kế thừa mọi giá trị mặc định được đặt ở cấp nhà quảng cáo. Đồng thời, thay đổi này sẽ gây ra những thay đổi sau đối với hành vi của API Display &Video 360 và Tệp dữ liệu có cấu trúc:

  • Các trường businessName, logologoImages trong tài nguyên ad_details Tạo nhu cầu AdGroupAd sẽ không còn bắt buộc nếu các giá trị mặc định được chỉ định cho nhà quảng cáo mẹ. Nếu không được cung cấp, quảng cáo sẽ kế thừa các giá trị mặc định ở cấp nhà quảng cáo.
  • Bạn có thể đặt các cột Business NameLogo Asset IDs trong tệp Ad SDF cho quảng cáo đối với quảng cáo thuộc bất kỳ loại nào sau đây: "Thích ứng", "Tạo nhu cầu cho sản phẩm", "Tạo nhu cầu dạng video", "Tạo nhu cầu dạng hình ảnh" và "Tạo nhu cầu dạng băng chuyền". Nếu bạn không đặt các cột này cho một mục quảng cáo có liên quan và các giá trị mặc định được chỉ định cho nhà quảng cáo mẹ, thì quảng cáo sẽ kế thừa các giá trị mặc định ở cấp nhà quảng cáo khi bạn lưu.
  • Các cột Business NameLogo Asset IDs trong tệp SDF cho quảng cáo không còn bắt buộc đối với quảng cáo Tạo nhu cầu nếu nhà quảng cáo mẹ đã chỉ định các giá trị mặc định.

Nếu các giá trị mặc định được đặt ở cấp nhà quảng cáo, thì tất cả quảng cáo thuộc nhà quảng cáo đó sẽ có một giá trị tên và biểu trưng doanh nghiệp được chỉ định. Nếu bạn muốn để trống các giá trị thành phần tên và biểu trưng doanh nghiệp cho quảng cáo thích ứng trên YouTube, đừng đặt các giá trị mặc định cho nhà quảng cáo của bạn.

Quản lý việc nhắm mục tiêu theo 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 hoạt động tính năng 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ẽ 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 tệp 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:

Các mục SDF cho 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 cho đơn đặt hàng quảng cáo 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 API Display &Video 360 hoặc tệp 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 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 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ả cá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 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 tệp 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 thuộc nhà quảng cáo của bạn, hãy cập nhật quá trình tích hợp API Display & Video 360 và tệ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 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 còn có 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 nữa 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. Để 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 nữa. Trường này sẽ bị xoá hoàn toàn vào một ngày sau đó.
  • Cột TrueView Content Filter trong tệp SDF cho mục hàng sẽ không còn ghi được nữa.
Để 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 hàng trong tệp SDF. Hãy để trống cột này khi tạo mục hàng mới.
Cập nhật ngân sách cho 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 còn có 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 các chiến lược đặt giá thầu tự động nữa.

Để 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 đó, tệp 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 mục tiêu các URL miễn là các URL đó được định dạng chính xác.

Đ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ố giá thầu" trong Tệp dữ liệu có cấu trúc cho 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ố 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 thêm 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 trình thực thi này bắt đầu, giá trị sẽ được điền lại cho các mục hàng hiện có và được thêm 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 để thêm 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ý các 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 trong tệp 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 còn có 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 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

Vào 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 vô hạn cho đối tượng nữa. 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 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 các gói thành viên của đối tượng So khớp khách hàng hiện có bằng cách sử dụng firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Thường xuyên làm mới các gói thành viên của đố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 đi ngoài ý muốn.

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 chỉ định cho một mục hàng trước hoặc cùng lúc với việc chỉ định 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ỷ chỉ định khỏi tất cả các mục hàng trước khi cố gắng cập nhật.

Các tính năng trước đây ngừng sử dụng

Để đọc về các tính năng đã thông báo ngừng sử dụng ảnh hưở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ữ.