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 Display & Video 360 API.

Ngày ngừng hoạt động và 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 Display & Video 360 API đượ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:

  • Bản 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ắp ngừng hoạt động và ngày kết thúc hỗ trợ (ngừng cung cấp) đã được công bố. 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 không còn được hỗ trợ. Các yêu cầu 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, ngày ngừng hoạt độ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

Theo dõi blog dành cho nhà phát triển Google Ads của chúng tôi để 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 này liệt kê tất cả các tính năng đã được thông báo ngừng hoạt động và ả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 hoạt độ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ả
Bạn phải cung cấp tên và biểu trưng doanh nghiệp cho quảng cáo thích ứng trên YouTube

Đã cập nhật Ngày có hiệu lực ban đầu

Tháng 1 năm 2027

Kể từ tháng 1 năm 2027, thành phần tên và biểu trưng doanh nghiệp sẽ là thành phần bắt buộc đối với quảng cáo thích ứng trên YouTube nếu nhà quảng cáo không đặt giá trị mặc định.

Do đó, bạn sẽ phải đặt các cột Business Name và Logo Asset IDs trong SDF Quảng cáo cho quảng cáo thuộc loại "Thích ứng" nếu giá trị mặc định không được chỉ định cho nhà quảng cáo mẹ. Nếu bạn chỉ định một giá trị mặc định và để trống cột này, thì quảng cáo sẽ kế thừa các giá trị mặc định ở cấp nhà quảng cáo khi lưu.

Ngừng sử dụng tính năng loại trừ danh mục nhạy cảm Ngày 1 tháng 10 năm 2026

Kể từ ngày 1 tháng 10 năm 2026, bạn sẽ không thể loại trừ hầu hết các danh mục nhạy cảm khi chỉ định tiêu chí nhắm mục tiêu của mục hàng. Để phù hợp với thay đổi này, chúng tôi sẽ thực hiện những thay đổi sau đối với Display & Video 360 API và Tệp dữ liệu có cấu trúc:

  • Các giá trị enum SensitiveCategory sau đây sẽ không được dùng nữa và không còn được chấp nhận trong trường excludedSensitiveCategory của đối tượng SensitiveCategoryAssignedTargetingOptionDetails khi chỉ định tiêu chí nhắm mục tiêu thuộc loại TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
    • SENSITIVE_CATEGORY_ADULT
    • SENSITIVE_CATEGORY_ALCOHOL
    • SENSITIVE_CATEGORY_DEROGATORY
    • SENSITIVE_CATEGORY_DOWNLOADS_SHARING
    • SENSITIVE_CATEGORY_DRUGS
    • SENSITIVE_CATEGORY_GAMBLING
    • SENSITIVE_CATEGORY_POLITICS
    • SENSITIVE_CATEGORY_PROFANITY
    • SENSITIVE_CATEGORY_RELIGION
    • SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES
    • SENSITIVE_CATEGORY_SHOCKING
    • SENSITIVE_CATEGORY_SUGGESTIVE
    • SENSITIVE_CATEGORY_TOBACCO
    • SENSITIVE_CATEGORY_TRAGEDY
    • SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS
    • SENSITIVE_CATEGORY_VIOLENCE
    • SENSITIVE_CATEGORY_WEAPONS
  • Cột Brand Safety Sensitivity Setting trong SDF Mục hàng sẽ không còn cho phép lựa chọn "Sử dụng tuỳ chỉnh".
  • Cột Brand Safety Custom Settings trong SDF Mục hàng sẽ không còn được hỗ trợ và sẽ được điền giá trị trống khi tải xuống.
Ngừng sử dụng tiêu chí loại trừ nhãn nội dung kỹ thuật số Ngày 1 tháng 10 năm 2026

Kể từ ngày 1 tháng 10 năm 2026, bạn sẽ không thể loại trừ các nhãn nội dung kỹ thuật số cụ thể bằng tiêu chí nhắm mục tiêu nữa. Để phù hợp với thay đổi này, chúng tôi sẽ thực hiện những thay đổi sau đối với Display & Video 360 API và Tệp dữ liệu có cấu trúc:

  • Các giá trị enum ContentRatingTier sau đây sẽ không được dùng nữa và không còn được chấp nhận trong trường excludedContentRatingTier của đối tượng DigitalContentLabelAssignedTargetingOptionDetails khi chỉ định tiêu chí nhắm mục tiêu thuộc loại TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
    • CONTENT_RATING_TIER_FAMILIES
    • CONTENT_RATING_TIER_GENERAL
    • CONTENT_RATING_TIER_MATURE
    • CONTENT_RATING_TIER_PARENTAL_GUIDANCE
    • CONTENT_RATING_TIER_TEENS
    • CONTENT_RATING_TIER_UNSPECIFIED
  • Cột Digital Content Labels - Exclude trong SDF Mục hàng sẽ chỉ cho phép chỉ định lựa chọn "?", nếu không thì cột này phải để trống. Nếu bạn cố gắng chỉ định bất kỳ giá trị nào khác, thì hệ thống sẽ báo lỗi khi tải lên.
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. Để phù hợp với thay đổi này, chúng tôi sẽ thực hiện những thay đổi sau đối với Display & Video 360 API và Tệp dữ liệu có cấu trúc:

Chúng tôi sẽ xoá Nielsen khỏi danh sách nhà cung cấp dịch vụ đo lường mức tăng thương hiệu hiện tại.

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

Kế thừa tên và biểu trưng mặc định của doanh nghiệp 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ợ 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 chưa đặt 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ẽ dẫn đến những thay đổi sau đây đối với hành vi của Display & Video 360 API và Tệp dữ liệu có cấu trúc:

  • Các trường businessName, logo và logoImages trong tài nguyên Tạo nhu cầu AdGroupAd của ad_details sẽ không còn bắt buộc nếu giá trị mặc định được chỉ định cho nhà quảng cáo mẹ. Nếu bạn không 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 Name và Logo Asset IDs trong SDF Quảng cáo cho những quảng cáo thuộc bất kỳ loại nào sau đây: "Thích ứng", "Sản phẩm Tạo nhu cầu", "Video Tạo nhu cầu", "Hình ảnh Tạo nhu cầu" và "Quảng cáo 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 phù hợp có liên quan và giá trị mặc định được chỉ định cho nhà quảng cáo chính, thì quảng cáo sẽ kế thừa giá trị mặc định ở cấp nhà quảng cáo khi lưu.
  • Các cột Business Name và Logo Asset IDs trong SDF 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 gốc đã chỉ định giá trị mặc định.

Nếu bạn đặt giá trị mặc định ở cấp nhà quảng cáo, thì tất cả quảng cáo của nhà quảng cáo đó sẽ có giá trị tên và biểu trưng doanh nghiệp được chỉ định. Nếu bạn muốn để trống giá trị của 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, hãy không đặt giá trị mặc định cho nhà quảng cáo.

Quản lý tiêu chí nhắm mục tiêu của đơn đặt hàng quảng cáo và chiến dịch 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

Kể từ ngày 23 tháng 2 năm 2026, Display & Video 360 sẽ ngừng hỗ trợ tiêu chí nhắm mục tiêu theo đơn đặt hàng quảng cáo và chiến dịch. 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 Display & Video 360 API, một số 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áo và Chiế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 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 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 nhập SDF của Đơ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ụ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 không có 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 đặ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 tài khoản nhà quảng cáo của bạn, hãy cập nhật Display & Video 360 API và chế độ 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 mục hàng của YouTube và đối tác 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ể sửa đổi cấu hình danh mục nội dung cho từng mục hàng YouTube và đối tác nữa. Đây là một phần trong bản cập nhật về trải nghiệm 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 những thay đổi sau đối với Display & Video 360 API và Tệp dữ liệu có cấu trúc:

  • Trường contentCategory trong đối tượng YoutubeAndPartnersSettings của tài nguyên LineItem trên YouTube và đối tác sẽ không được cập nhật nữa. Tính năng này sẽ bị xoá hoàn toàn vào một ngày sau đó.
  • 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ụ:
  • 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 mục hàng SDF. Để trống cột này khi tạo mục hàng mới.
Nội dung cập nhật về ngân sách của mục hàng khi 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 những mục hàng có đơn đặt hàng quảng cáo chính đượ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:
Các 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 hạn chế này không cho phép các trang web mới hơn được đưa 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 mục tiêu theo URL miễn là các URL đó được định dạng chính xác.

Điều này liên quan đến các cột Site Targeting - Include và Site Targeting - Exclude trong tệp Đơn đặt hàng quảng cáo và Mụ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

Kể từ ngày 1 tháng 5 năm 2025, các mục trong Tệp dữ liệu có cấu trúc của 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 của đối tác video cho các 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 mục hàng có giá trị cột Type là "Tạo nhu cầu". Sau khi bắt đầu thực thi, giá trị này 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 Demand Gen Inventory Source Strategy và Demand Gen Enabled Inventory Sources trong Nhóm quảng cáo SDF phiên bản 8.1.
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 lên chiến dịch Tạo nhu cầu. Các mục Mục hàng được 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 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 của 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, các tài nguyên FirstAndThirdPartyAudience sẽ không còn cho phép thời hạn thành viên trong phân khúc đối tượng là vô thời hạn. Các yêu cầu firstAndThirdPartyAudiences.create và firstAndThirdPartyAudiences.patch đặt giá trị trường membershipDurationDays thành 10.000 sẽ trả về lỗi 400. Những đố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ẽ khiến tất cả tư cách thành viên cũ hơn 540 ngày hết hạn.

Để 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 tại thành 10.000.
  • Làm mới danh sách 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 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 của bạn không bị thu hẹp ngoài ý muốn.

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

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 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 cập nhật.

Các tính năng đã ngừng hoạt động trước đây

Để đọc về các tính năng ngừng hoạt động đã được thông báo và ả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 tính năng ngừng hoạt động đã lưu trữ của chúng tôi.