Method: customers.batchJobs.addOperations

Thêm thao tác vào công việc hàng loạt.

Danh sách lỗi đã gửi: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v16/{resourceName=customers/*/batchJobs/*}:addOperations

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

Tham số đường dẫn

Tham số
resourceName

string

Bắt buộc. Tên tài nguyên của công việc theo lô.

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 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Trường
sequenceToken

string

Mã thông báo được dùng để thực thi tính năng sắp xếp theo trình tự.

Yêu cầu lôjob.addOperations đầu tiên cho một công việc hàng loạt không được đặt sạnToken. Các yêu cầu tiếp theo phải đặt stringsToken thành giá trị của nextSequenceToken đã nhận được trong phản hồi BulkTransaction.addOperations trước đó.
mutateOperations[]

object (MutateOperation)

Bắt buộc. Danh sách các biến đổi đang được thêm.

Các thao tác có thể sử dụng số nguyên âm làm mã nhận dạng tạm thời để biểu thị các phần phụ thuộc giữa các thực thể được tạo trong công việc theo lô này. Ví dụ: khách hàng có id = 1234 có thể tạo chiến dịch và nhóm quảng cáo trong cùng chiến dịch đó bằng cách tạo chiến dịch trong hoạt động đầu tiên với tên tài nguyên được đặt rõ ràng là "khách hàng/1234/campaigns/-1" và tạo nhóm quảng cáo trong hoạt động thứ hai với trường chiến dịch cũng được đặt thành "khách hàng/1234/campaigns/-1".

Nội dung phản hồi

Tin nhắn phản hồi cho BatchJobService.AddBatchJobOperations.

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 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Trường
totalOperations

string (int64 format)

Tổng số thao tác đã thêm tính đến nay cho công việc theo lô này.
nextSequenceToken

string

Bạn có thể sử dụng mã thông báo trình tự khi gọi lại lôJob.addOperations nếu cần thêm các thao tác khác. Yêu cầu lôtrình làm việc.addOperations tiếp theo phải đặt trường chuỗiToken thành giá trị của trường này.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/adwords

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.