Di chuyển từ phiên bản 3 sang phiên bản 4

Lần cập nhật gần đây nhất: ngày 31 tháng 7 năm 2025

Di chuyển ứng dụng

Để di chuyển từ phiên bản 3 sang phiên bản 4, bạn cần cập nhật URL điểm cuối để gọi phiên bản 4 và cập nhật ứng dụng để tính đến các thay đổi có thể gây lỗi.

Cập nhật các lệnh gọi API từ phiên bản 3 lên phiên bản 4

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

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

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

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

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

Nếu bạn đang sử dụng một thư viện ứng dụng để đưa ra yêu cầu cho 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 4.

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

Chúng tôi sẽ giới thiệu một số thay đổi có thể gây lỗi trong phiên bản 4. Hãy xem kỹ các 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 Display & Video 360 API.

Cập nhật lệnh gọi liên quan đến tài nguyên đối tượng bên thứ nhất và bên thứ ba cũng như tiêu chí nhắm mục tiêu có liên quan

Tài nguyên FirstAndThirdPartyAudience đã được thay thế bằng tài nguyên FirstPartyAndPartnerAudience.

Bạn cần cập nhật những nội dung sau để áp dụng thay đổi này:

• Tham chiếu đến các tài nguyên FirstAndThirdPartyAudience để sử dụng tài nguyên FirstPartyAndPartnerAudience mới.
• Các yêu cầu hiện có đối với các phương thức trong dịch vụ firstAndThirdPartyAudiences phiên bản 3 đối với dịch vụ firstPartyAndPartnerAudiences phiên bản 4 mới.
• Kỳ vọng về kích thước trang mặc định cho các yêu cầu firstPartyAndPartnerAudiences.list từ 100 đến 5.000 mục.
• Tham chiếu đến trường firstAndThirdPartyAudienceType v3 cho trường firstPartyAndPartnerAudienceType v4 mới, sử dụng kiểu liệt kê FirstPartyAndPartnerAudienceType mới, với các giá trị cũ tương ứng với các giá trị mới sau:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY đến TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY đến TYPE_PARTNER

• Các tham chiếu đến giá trị enum AudienceType LICENSED để thay vào đó sử dụng một trong các giá trị mới, cụ thể hơn sau đây:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Các tham chiếu đến tài nguyên AssignedTargetingOption của TargetingType TARGETING_TYPE_AUDIENCE_GROUP để thay thế các trường v3 trong AudienceGroupAssignedTargetingOptionDetails bằng các trường v4 mới sau đây:

  • excludedFirstAndThirdPartyAudienceGroup với excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups với includedFirstPartyAndPartnerAudienceGroups

Cập nhật các yêu cầu nhắm mục tiêu theo danh sách lớn của nhóm quảng cáo hiện có

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions đã đổi tên thành advertisers.adGroups.bulkListAssignedTargetingOptions. Cập nhật các yêu cầu hiện có để sử dụng tên phương thức mới.

Thêm mục tiêu tối ưu hoá khi tạo đơn đặt hàng quảng cáo

optimizationObjective hiện là trường bắt buộc trong tài nguyên InsertionOrder. Cập nhật các yêu cầu advertisers.insertionOrders.create để xác minh rằng trường này đã được đặt.

Xoá các tham chiếu đến trường tài nguyên mẫu quảng cáo publisherReviewStatuses

Trường publisherReviewStatuses đã bị xoá khỏi đối tượng ReviewStatusInfo trong tài nguyên Creative sau khi ngừng hoạt động vào tháng 6 năm 2024.