Method: customers.batchJobs.addOperations

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

string

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

คำขอ setJobs.addOperations แรกสำหรับงานแบบกลุ่มไม่ควรตั้งค่าลำดับโทเค็น คำขอที่ตามมาต้องตั้ง sectionToken เป็นค่าของ nextSequenceToken ที่ได้รับในการตอบรับแสดงให้เห็นเป็น applicationJobs.addOperations ก่อนหน้า
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

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

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

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

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

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