Method: advertisers.lineItems.bulkUpdate

Cập nhật nhiều mục hàng.

Bạn không thể đưa ra yêu cầu đến điểm cuối này đồng thời với các yêu cầu sau đây để cập nhật cùng một mục hàng:

Bạn không thể tạo hoặc cập nhật mục hàng của YouTube và đối tác bằng API.

Yêu cầu HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo mà mục hàng này thuộc về.

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 (LineItem)
  },
  "updateMask": string
}
Trường
lineItemIds[]

string (int64 format)

Bắt buộc. Mã nhận dạng của các mục hàng cần cập nhật.
targetLineItem

object (LineItem)

Bắt buộc. Một đối tượng mục hàng chứa các trường cần cập nhật và các giá trị mới cần chỉ định cho tất cả mục hàng được chỉ định trong lineItemIds."
updateMask

string (FieldMask format)

Bắt buộc. Một mặt nạ cho trường (field mask) xác định những trường cần cập nhật.

Hiện tại, chỉ những trường sau được hỗ trợ:

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

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 (Status)
    }
  ]
}
Trường
updatedLineItemIds[]

string (int64 format)

Mã nhận dạng của các mục hàng đã được cập nhật thành công.
failedLineItemIds[]

string (int64 format)

Mã nhận dạng của những mục hàng không cập nhật được.
skippedLineItemIds[]

string (int64 format)

Mã nhận dạng của các mục hàng bị bỏ qua khi cập nhật. Ví dụ: những thao tác sửa đổi không cần thiết sẽ không dẫn đến bất kỳ thay đổi nào đối với mục hàng sẽ bị bỏ qua và bạn có thể theo dõi các mã mục hàng tương ứng tại đây.
errors[]

object (Status)

Lỗi do các 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 OAuth 2.0 Overview.