Display & Video 360 API hiện hỗ trợ hoạt động quản lý tài nguyên của chiến dịch Tạo nhu cầu. Hãy xem hướng dẫn mới của chúng tôi để tìm hiểu cách tạo và chạy chiến dịch quảng cáo Tạo nhu cầu.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Di chuyển từ Display & Video 360 API phiên bản 4 sang phiên bản 5

Lần cập nhật gần đây nhất: 22/10/2026

Di chuyển ứng dụng

Để di chuyển từ phiên bản 4 sang phiên bản 5, bạn cần cập nhật URL điểm cuối để gọi phiên bản 5, cập nhật ứng dụng để tính đến các thay đổi có thể gây lỗi và xem xét mọi tính năng mới có thể mang lại lợi ích cho quá trình tích hợp của bạn.

Cập nhật lệnh gọi API từ phiên bản v4 lên v5

Để sử dụng phiên bản 5 thay vì phiên bản 4, bạn cần cập nhật các yêu cầu để sử dụng điểm cuối mới của phiên bản 5.

Ví dụ: để gọi phương thức advertisers.get bằng v4, hãy sử dụng URL sau:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

Đối với phiên bản 5, hãy cập nhật URL thành:

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

Nếu bạn đang sử dụng một thư viện ứng dụng để gửi yêu cầu đến API, hãy sử dụng phiên bản mới nhất của thư viện ứng dụng và cập nhật cấu hình để sử dụng phiên bản 5.

Thực hiện các thay đổi bắt buộc

Display & Video 360 API phiên bản 5 có một số thay đổi có thể gây lỗi. Hãy xem hướng dẫn sau đây và thực hiện những thay đổi cần thiết liên quan đến việc bạn đang sử dụng API Display & Video 360.

Để biết danh sách đầy đủ về những điểm khác biệt giữa Display & Video 360 API phiên bản 4 và phiên bản 5, hãy xem ghi chú phát hành.

Cập nhật tiêu chí nhắm mục tiêu và truy xuất nguồn khoảng không quảng cáo để sử dụng mã nhận dạng và loại mới

Display & Video 360 API phiên bản 5 thay đổi cách truy xuất và nhắm mục tiêu các giao dịch nguồn khoảng không quảng cáo và gói đấu giá.

Trong phiên bản 4, các tài nguyên InventorySource được truy xuất bằng dịch vụ inventorySources đại diện cho cả giao dịch nguồn khoảng không quảng cáo và gói đấu giá. Cả giao dịch và gói đấu giá đều được nhắm mục tiêu bằng TARGETING_TYPE_INVENTORY_SOURCE.

Trong phiên bản 5, các giao dịch và gói đấu giá của nguồn khoảng không quảng cáo được xử lý riêng:

Giao dịch nguồn khoảng không quảng cáo được nhắm mục tiêu bằng TARGETING_TYPE_INVENTORY_SOURCE_DEAL, được truy xuất bằng dịch vụ advertisers.inventorySources và partners.inventorySources, đồng thời được nhắm mục tiêu bằng trường AssignedTargetingOption inventorySourceDetails.
Gói đấu giá được nhắm mục tiêu bằng TARGETING_TYPE_AUCTION_PACKAGE, được truy xuất bằng dịch vụ targetingTypes.targetingOptions và được nhắm mục tiêu bằng trường AssignedTargetingOption auctionPackageDetails.

Nội dung cập nhật này thay đổi mã nhận dạng dùng cho các giao dịch và gói đấu giá hiện có, vì vậy, bạn không thể sử dụng bất kỳ mã tài nguyên InventorySource nào đã lưu vào bộ nhớ đệm trước đó sau khi di chuyển.

Ngoài những thay đổi này, phiên bản 5 cũng xoá bỏ khả năng tạo, cập nhật và chỉnh sửa trình truy cập của nguồn khoảng không quảng cáo.

Cập nhật logic nhắm mục tiêu theo đối tượng cho tài nguyên của chiến dịch Tạo nhu cầu và YouTube

API Display & Video 360 phiên bản 5 cập nhật logic nhắm mục tiêu theo đối tượng cho các tài nguyên Tạo nhu cầu và YouTube để sử dụng các lựa chọn được chỉ định riêng cho từng danh sách đối tượng được nhắm mục tiêu.

Trong phiên bản 4, tất cả tiêu chí nhắm mục tiêu theo đối tượng đều được quản lý bằng TARGETING_TYPE_AUDIENCE_GROUP.

Trong phiên bản 5, tiêu chí nhắm mục tiêu theo đối tượng được chỉ định cho nhóm quảng cáo Tạo nhu cầu và nhóm quảng cáo trên YouTube được quản lý bằng một trong các loại tiêu chí nhắm mục tiêu và trường tài nguyên AssignedTargetingOption sau đây, tuỳ thuộc vào loại đối tượng:

TARGETING_TYPE_COMBINED_AUDIENCE sử dụng combinedAudienceDetails
TARGETING_TYPE_CUSTOM_LIST bằng customListDetails
TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE sử dụng firstPartyAndPartnerAudienceDetails
TARGETING_TYPE_GOOGLE_AUDIENCE sử dụng googleAudienceDetails
TARGETING_TYPE_LOOKALIKE_AUDIENCE sử dụng lookalikeAudienceDetails

Các mục hàng sẽ tiếp tục sử dụng một TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption để quản lý tiêu chí nhắm mục tiêu theo đối tượng cho tất cả các loại.

Nâng cấp lên Data Manager API để quản lý đối tượng So khớp khách hàng

Display & Video 360 API phiên bản 5 loại bỏ khả năng tạo và quản lý thành viên của đối tượng So khớp khách hàng bằng cách xoá các phương thức sau:

firstPartyAndPartnerAudiences.create
firstPartyAndPartnerAudiences.editCustomerMatchMembers
firstPartyAndPartnerAudiences.patch

Để tiếp tục quản lý đối tượng So khớp khách hàng, hãy nâng cấp quy trình công việc để sử dụng Data Manager API.

Thêm tính năng hỗ trợ truy xuất đơn đặt hàng quảng cáo kỹ thuật số ngoài trời

Display & Video 360 API phiên bản 5 bổ sung tính năng hỗ trợ truy xuất đơn đặt hàng quảng cáo kỹ thuật số ngoài trời.

Nếu nhà quảng cáo của bạn sử dụng quảng cáo kỹ thuật số ngoài trời, hãy nâng cấp mọi hoạt động tích hợp gọi advertisers.insertionOrders.list để chuẩn bị cho việc đưa tài nguyên InsertionOrder vào với giá trị trường insertionOrderType là OUT_OF_HOME.

Trong phiên bản 5, bạn vẫn có thể truy xuất các mục hàng trong đơn đặt hàng quảng cáo kỹ thuật số ngoài trời như trong phiên bản 4.

Cập nhật thông tin tham chiếu đến Adloox thành Peer39

Trong phiên bản 5, các trường và giá trị enum tham chiếu đến tính năng tích hợp mức độ phù hợp với thương hiệu của bên thứ ba trong Display & Video 360 với Adloox (còn gọi là Scope3) đã được cập nhật thành Peer39:

Trường ThirdPartyVerifierAssignedTargetingOptionDetails adloox đã được thay thế bằng peer39.
Các giá trị enum PartnerCostType PARTNER_COST_TYPE_ADLOOX và PARTNER_COST_TYPE_ADLOOX_PREBID đã được thay thế bằng PARTNER_COST_TYPE_PEER39 và PARTNER_COST_TYPE_PEER39_PREBID.

Cập nhật các trường cho mục hàng, nhóm quảng cáo và quảng cáo trên YouTube

Trong phiên bản 5, nhiều trường trong các tài nguyên LineItem, AdGroup và AdGroupAd đã bị xoá hoặc cập nhật. Hãy cập nhật logic truy xuất tài nguyên để tính đến những thay đổi này.

Trong tài nguyên LineItem:

Trường YoutubeAndPartnersSettings relatedVideoIds đã được thay thế bằng relatedVideos.

Trong tài nguyên LineItem và AdGroup:

Các trường TargetingExpansionConfig audienceExpansionSeedListExcluded và audienceExpansionLevel đã bị xoá.

Trong tài nguyên AdGroupAd:

Đã thêm trường containsSyntheticMedia.
Trường trackingUrl trong các đối tượng AudioAd, CommonInStreamAttribute và VideoPerformanceAd đã được chia thành hai trường là trackingUrl và userSpecifiedTrackingUrl để phân biệt giữa URL dùng để theo dõi và URL theo dõi do người dùng chỉ định.

Xoá các tệp đối chiếu đến giá trị enum không dùng nữa

Trong phiên bản 5, các giá trị enum không dùng nữa trước đây đã bị xoá hoàn toàn. Mặc dù việc sử dụng các giá trị này trong yêu cầu gửi đến API sẽ dẫn đến lỗi trong phiên bản 4, nhưng thay đổi này sẽ xoá mọi thông tin tham chiếu đến các giá trị đó khỏi thư viện ứng dụng phiên bản 5. Mọi tệp tham chiếu đến các giá trị không dùng nữa này trong mã của bạn đều có thể gây ra lỗi khi nâng cấp lên phiên bản 5.

Các loại enum có giá trị bị ảnh hưởng bao gồm ContentRatingTier, GoogleAudienceType, SdfVersion và SensitiveCategory. Hãy xem ghi chú phát hành của chúng tôi để biết danh sách đầy đủ về tất cả giá trị enum đã bị xoá.

Xem xét các tính năng mới

Ngoài những thay đổi có thể gây lỗi, phiên bản 5 cũng ra mắt các tính năng mới sau:

Quản lý toàn bộ tiêu chí nhắm mục tiêu loại trừ video trên YouTube và kênh ở cấp nhà quảng cáo theo các loại tiêu chí nhắm mục tiêu TARGETING_TYPE_YOUTUBE_VIDEO và TARGETING_TYPE_YOUTUBE_CHANNEL. Trong phiên bản 4, tiêu chí nhắm mục tiêu này ở chế độ chỉ có thể đọc.
Khả năng tạo tài nguyên InsertionOrder cho quảng cáo kỹ thuật số ngoài trời.
Hỗ trợ các nhóm quảng cáo sử dụng mẫu quảng cáo được chỉ định để tạo quảng cáo thông qua việc bổ sung các trường AdGroup adSource và creativeAssignments cũng như trường AdGroupAd parentCreativeId.
Khả năng tạo và truy xuất tài nguyên LookalikeAudience.
Trường containsSyntheticMedia mới trong tài nguyên AdGroupAd.