Method: customers.adGroupCustomizers.mutate

สร้าง อัปเดต หรือนำเครื่องมือปรับแต่งกลุ่มโฆษณาออก ระบบจะแสดงผลสถานะการดำเนินการ

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/adGroupCustomizers:mutate

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่กำลังแก้ไขเครื่องมือปรับแต่งกลุ่มโฆษณา

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

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

การแสดง JSON
{
  "operations": [
    {
      object (AdGroupCustomizerOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
ช่อง
operations[]

object (AdGroupCustomizerOperation)

ต้องระบุ รายการการดำเนินงานที่จะดำเนินการกับเครื่องมือปรับแต่งกลุ่มโฆษณาแต่ละกลุ่ม

partialFailure

boolean

หากค่าเป็น "จริง" ระบบจะดําเนินการสําเร็จและการดําเนินการที่ไม่ถูกต้องจะแสดงข้อผิดพลาด หากเป็นเท็จ การดำเนินการทั้งหมดจะเกิดขึ้นในธุรกรรมเดียวในกรณีที่การดำเนินการทั้งหมดถูกต้องเท่านั้น ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้ที่ false

validateOnly

boolean

หากเป็นจริง คำขอจะได้รับการตรวจสอบแต่ไม่มีการดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดเท่านั้น ไม่ใช่ผลลัพธ์

responseContentType

enum (ResponseContentType)

การตั้งค่าประเภทเนื้อหาของการตอบกลับ กำหนดว่าควรแสดงผลทรัพยากรที่เปลี่ยนแปลงได้หรือเฉพาะชื่อทรัพยากรหลังการเปลี่ยนแปลง

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

ข้อความตอบกลับสําหรับการเปลี่ยนแปลงเครื่องมือปรับแต่งโฆษณา

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

การแสดง JSON
{
  "results": [
    {
      object (MutateAdGroupCustomizerResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
ช่อง
results[]

object (MutateAdGroupCustomizerResult)

ผลลัพธ์ทั้งหมดสำหรับการเปลี่ยนแปลง

partialFailureError

object (Status)

ข้อผิดพลาดที่เกี่ยวข้องกับความล้มเหลวในการดำเนินการในโหมดการทำงานล้มเหลวบางส่วน แสดงผลเฉพาะเมื่อบางส่วนFailure = true และข้อผิดพลาดทั้งหมดเกิดขึ้นภายในการดำเนินการ หากมีข้อผิดพลาดเกิดขึ้นนอกการดำเนินการ (เช่น ข้อผิดพลาดในการตรวจสอบสิทธิ์) เราจะแสดงผลข้อผิดพลาดระดับ RPC

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

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

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

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