Hiển thị và Video 360 API phiên bản 2 sẽ ngừng hoạt động từ ngày 3 tháng 9 năm 2024. Hãy chuyển sang phiên bản 3 trước thời điểm đó để tránh bị gián đoạn dịch vụ.

Trang này được dịch bởi Cloud Translation API.

Chuyển từ phiên bản 1 sang phiên bản 2

Lần cập nhật gần đây nhất: 6/12/2022

Di chuyển ứng dụng

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

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

Để sử dụng v2 thay vì v1, bạn cần cập nhật các yêu cầu để sử dụng các điểm cuối v2 mới.

Ví dụ: để gọi phương thức advertisers.get bằng v1, bạn sẽ sử dụng URL sau:

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

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

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

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

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

Chúng tôi sẽ ra mắt một số thay đổi có thể gây lỗi trong phiên bản 2. Xem lại các hướng dẫn sau và thực hiện các thay đổi cần thiết có liên quan đến hoạt động sử dụng API Display & Video 360 hiện tại của bạn.

Cập nhật lệnh gọi cho phương pháp nhắm mục tiêu

Một số loại nhắm mục tiêu hiện được chỉ định bằng cách sử dụng các giá trị enum thay vì mã tuỳ chọn nhắm mục tiêu. Ví dụ: các thiết bị máy tính bảng hiện được nhắm mục tiêu trực tiếp bằng enum DEVICE_TYPE_TABLET DeviceType, thay vì mã nhận dạng tuỳ chọn nhắm mục tiêu từ dịch vụ targetingTypes.targetingOptions. Phiên bản chuỗi của các enum này được biểu thị trong trường assignedTargetingOptionIdAlias mới trong các tài nguyên AssignedTargetingOption này và có thể dùng khi truy xuất hoặc xoá tiêu chí nhắm mục tiêu hiện có. Giá trị assignedTargetingOptionId của các tài nguyên AssignedTargetingOption này không thay đổi.

Cập nhật các lệnh gọi quản lý các loại nhắm mục tiêu sau đây để sử dụng giá trị enum:
Phương thức advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions đã được thay thế bằng phương thức advertisers.lineItems.bulkEditAssignedTargetingOptions.
Phương thức advertisers.lineItems.bulkListLineItemAssignedTargetingOptions đã được thay thế bằng phương thức advertisers.lineItems.bulkListAssignedTargetingOptions.
Cập nhật các lệnh gọi quản lý TARGETING_TYPE_PROXIMITY_LOCATION_LIST để sử dụng kích thước bán kính và đơn vị khoảng cách đã đặt thay vì giá trị enum ProximityRadiusRange.
Các phương pháp nhắm mục tiêu truy xuất hoặc chỉnh sửa tuỳ chọn nhắm mục tiêu trên nhiều loại nhắm mục tiêu trong một tài nguyên mẹ đã được đổi tên.

Cập nhật lệnh gọi thành các phương thức sau để sử dụng tên mới của chúng:

Cập nhật cuộc gọi lên dịch vụ `advertisers.lineItems`

Trường inventorySourceIds đã bị xoá. Quản lý việc chỉ định nguồn khoảng không quảng cáo bằng cách sử dụng tài nguyên AssignedTargetingOption của TARGETING_TYPE_INVENTORY_SOURCE.
Các giá trị enum LineItemWarningMessage sau đây đã không còn được dùng trong phiên bản 2 và sẽ không còn xuất hiện trong LineItem.warningMessages:
- NO_POSITIVE_AUDIENCE_LIST_TARGETED
- APP_INSTALL_NO_CONVERSION_PIXEL
- TARGETING_REVOKED_OR_CLOSED_USER_LIST
- APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
- CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
- NO_CREATIVE_FOR_TARGETED_DEALS
- TARGETING_DEPRECATED_GEO_TARGET
Trường triggerId đã bị xoá khỏi đối tượng LineItemFlight và giá trị LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER đã bị xoá khỏi loại enum LineItemFlightDateType. phiên bản 2 không hỗ trợ đặt mục hàng thành mức chi tiêu dựa trên việc kích hoạt trình kích hoạt thủ công.

Cập nhật cuộc gọi lên dịch vụ `customBiddingAlgorithms`

Các trường customBiddingAlgorithmState và modelReadiness đã được thay thế bằng trường modelDetails . Trường này cung cấp trạng thái trạng thái sẵn sàng và tạm ngưng của mô hình thuật toán hiện có cho mỗi nhà quảng cáo có quyền truy cập thông qua danh sách đối tượng CustomBiddingModelDetails.

Các nội dung thay đổi khác

Ngoài những thay đổi có thể gây lỗi nêu trên, phiên bản 2 cũng giới thiệu các tính năng mới.

Bạn có thể xem các tính năng được thêm vào phiên bản 2 sau lần phát hành đầu tiên trong ghi chú phát hành của chúng tôi.

Quyền truy cập chỉ đọc vào các mục hàng YouTube

Trong phiên bản 2, bạn có thể truy xuất các mục hàng YouTube và chế độ cài đặt nhắm mục tiêu của chúng bằng dịch vụ advertisers.lineItems và advertisers.lineItems.targetingTypes.assignedTargetingOptions tương ứng. API cung cấp quyền chỉ có thể đọc, nghĩa là mọi yêu cầu đã thử ghi đối với các mục hàng này sẽ trả về lỗi. Các mục hàng YouTube sẽ thuộc một trong các giá trị LineItemType sau:

Các phương thức mới giúp nâng cao hiệu suất

Trong phiên bản 2, dịch vụ advertisers.lineItems cung cấp các phương thức mới để sử dụng thay cho các yêu cầu theo lô nhằm cải thiện hiệu suất và giảm mức tiêu thụ hạn mức:

Bạn có thể sử dụng advertisers.lineItems.bulkUpdate để đặt cùng một giá trị trường cho nhiều mục hàng. Hiện tại, chỉ hỗ trợ nội dung cập nhật cho trường entityStatus.
Bạn có thể sử dụng advertisers.lineItems.bulkEditAssignedTargetingOptions để thêm hoặc xoá cùng các tuỳ chọn nhắm mục tiêu được chỉ định trên nhiều mục hàng.
Bạn có thể sử dụng advertisers.lineItems.bulkListAssignedTargetingOptions để liệt kê các tuỳ chọn nhắm mục tiêu được chỉ định trên nhiều mục hàng.
Bạn có thể sử dụng advertisers.lineItems.duplicate để tạo bản sao của một mục hàng hiện có trong cùng một đơn đặt hàng quảng cáo, sao chép tất cả các cấu hình và chế độ cài đặt nhắm mục tiêu.

Quyền ghi một phần để nhắm mục tiêu theo thứ tự chèn

Trong phiên bản 2, bạn có thể chỉnh sửa một tập hợp con chế độ cài đặt nhắm mục tiêu cho các tài nguyên InsertionOrder bằng cách sử dụng các phương thức create và delete mới trong dịch vụ advertisers.insertionOrders.targetingTypes.assignedTargetingOptions. Bạn có thể quản lý hoàn toàn các loại nhắm mục tiêu sau đây ở cấp độ thứ tự chèn:

TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_GENDER
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_VIEWABILITY