Cập nhật nhiều mục hàng.
Không thể thực hiện yêu cầu gửi đến điểm cuối này đồng thời với các yêu cầu sau đây về việc cập nhật cùng một mục hàng:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
Bạn không thể tạo hoặc cập nhật mục hàng YouTube và Đối tác bằng API.
Yêu cầu HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
advertiserId |
Bắt buộc. Mã nhận dạng của nhà quảng cáo chứa mục hàng này. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
Trường | |
---|---|
lineItemIds[] |
Bắt buộc. Mã của mục hàng cần cập nhật. |
targetLineItem |
Bắt buộc. Một đối tượng mục hàng chứa các trường sẽ được cập nhật và các giá trị mới để chỉ định cho tất cả mục hàng được chỉ định trong |
updateMask |
Bắt buộc. Mặt nạ trường (field mask) giúp xác định các trường cần cập nhật. Hiện tại, chúng tôi chỉ hỗ trợ các trường sau: Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: |
Nội dung phản hồi
Thông báo phản hồi cho LineItemService.BulkUpdateLineItems.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
Trường | |
---|---|
updatedLineItemIds[] |
Mã của các mục hàng được cập nhật thành công. |
failedLineItemIds[] |
Mã của những mục hàng không cập nhật được. |
skippedLineItemIds[] |
Mã của các mục hàng bị bỏ qua khi cập nhật. Ví dụ: các thay đổi không cần thiết sẽ dẫn đến việc không có thay đổi nào đối với mục hàng được bỏ qua và bạn có thể theo dõi mã mục hàng tương ứng tại đây. |
errors[] |
Lỗi do mục hàng không cập nhật được trả về. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/display-video
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.