Method: customers.batchJobs.addOperations

เพิ่มการดำเนินการให้กับงานแบบกลุ่ม

รายการข้อผิดพลาดโยน: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
resourceName

string

ต้องระบุ ชื่อทรัพยากรของงานแบบกลุ่ม

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
ช่อง
sequenceToken

string

โทเค็นที่ใช้เพื่อบังคับใช้การเรียงลำดับ

คำขอ groupJobs.addOpss รายการแรกสำหรับงานกลุ่มไม่ควรตั้งค่า sameToken คำขอที่ตามมาต้องตั้งค่าลำดับความสำคัญโทเค็นให้กับค่าของ nextSequenceToken ที่ได้รับในการตอบสนอง groupJobs.addOperatings ก่อนหน้า
mutateOperations[]

object (MutateOperation)

ต้องระบุ รายการของการเปลี่ยนแปลงที่เพิ่ม

การดำเนินการสามารถใช้จำนวนเต็มลบเป็นรหัสชั่วคราวเพื่อระบุทรัพยากร Dependency ระหว่างเอนทิตีที่สร้างในงานแบบกลุ่มนี้ เช่น ลูกค้าที่มีรหัส = 1234 จะสามารถสร้างแคมเปญและกลุ่มโฆษณาในแคมเปญเดียวกันนั้นได้ด้วยการสร้างแคมเปญในการดําเนินการแรกโดยมีชื่อทรัพยากรเป็น "customers/1234/campaigns/-1" อย่างชัดเจน และสร้างกลุ่มโฆษณาในการดำเนินการที่ 2 โดยตั้งค่าช่องแคมเปญเป็น "customers/1234/campaigns/-1" ด้วย

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ BatchJobService.AddBatchJobOperations

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
ช่อง
totalOperations

string (int64 format)

จำนวนการดำเนินการทั้งหมดที่เพิ่มจนถึงปัจจุบันสำหรับงานแบบกลุ่มนี้
nextSequenceToken

string

โทเค็นลำดับที่จะใช้เมื่อเรียกใช้ groupJobs.addOperatings อีกครั้งหากต้องเพิ่มการดำเนินการเพิ่มเติม คำขอ groupJobs.addOperatings ถัดไปต้องตั้งค่าฟิลด์ orderToken เป็นค่าของช่องนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0