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 v2, bạn phải cập nhật URL điểm cuối để gọi phiên bản v2 và cập nhật ứng dụng của bạn cho phù hợp với 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 1 sang phiên bản 2

Để sử dụng phiên bản 2 thay vì phiên bản 1, bạn cần cập nhật các yêu cầu của mình để sử dụng phiên bản mới 2 điểm cuố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 tới API, hãy sử dụng phiên bản gần đây của thư viện ứng dụng 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 những nội dung sau và thực hiện những thay đổi cần thiết phù hợp với cách bạn đang sử dụng Hiển thị và API Video 360.

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 giá trị enum thay vì nhắm mục tiêu mã lựa chọn. Ví dụ: giờ đây, thiết bị máy tính bảng được nhắm mục tiêu trực tiếp bằng Enum DEVICE_TYPE_TABLET DeviceType, thay vì ID tùy chọn nhắm mục tiêu từ targetingTypes.targetingOptions. Phiên bản chuỗi của những enum này được biểu thị trong assignedTargetingOptionIdAlias trong AssignedTargetingOption tài nguyên và có thể được dùng khi truy xuất hoặc đang xoá tiêu chí nhắm mục tiêu hiện tại. Giá trị assignedTargetingOptionId trong số AssignedTargetingOption tài nguyên 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 các 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 cuộc gọi quản lý TARGETING_TYPE_PROXIMITY_LOCATION_LIST để sử dụng kích thước bán kính đã đặt và đơn vị khoảng cách thay vì Giá trị enum ProximityRadiusRange.
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 dưới một tài nguyên mẹ đã được đổi tên.

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

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

Đã xoá trường inventorySourceIds. Quản lý chỉ định nguồn khoảng không quảng cáo bằng tài nguyên AssignedTargetingOption trong tổng số TARGETING_TYPE_INVENTORY_SOURCE.
Các giá trị enum LineItemWarningMessage sau đây có không được dùng nữa 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 LineItemFlight và đối tượng 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 để chi tiêu dựa trên việc kích hoạt điều kiện kích hoạt thủ công.

Cập nhật cuộc gọi thành dịch vụ `customBiddingAlgorithms`

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

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 AI 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 tại ghi chú phát hành.

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

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

Các phương pháp mới mang lại hiệu suất tốt hơn

Trong phiên bản 2, dịch vụ advertisers.lineItems cung cấp để sử dụng thay cho yêu cầu được phân theo lô để đạt được hiệu quả cao hơn và giảm mức sử dụng hạn mức:

Bạn có thể sử dụng advertisers.lineItems.bulkUpdate để đặt các giá trị trường giống nhau cho nhiều mục hàng. Chỉ những bản cập nhật cho Trường entityStatus hiện được hỗ trợ.
Bạn có thể sử dụng advertisers.lineItems.bulkEditAssignedTargetingOptions để thêm hoặc xóa các tùy chọn nhắm mục tiêu được chỉ định trên nhiều dòng mục.
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 một bản sao của mục hàng hiện có trong cùng một đơn đặt hàng quảng cáo, sao chép toàn bộ cấu hình và cài đặt nhắm mục tiêu.

Quyền ghi một phần để nhắm mục tiêu đơn đặt hàng quảng cáo

Trong phiên bản 2, bạn có thể chỉnh sửa một chế độ cài đặt tiêu chí nhắm mục tiêu tập hợp con cho InsertionOrder bằng cách sử dụng create mới và delete trong 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 khi chèn cấp đơn đặt hàng:

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