Method: customers.keywordPlanAdGroups.mutate

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

รายการข้อผิดพลาดที่ถูกโยน: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateErrorQuotaErrorRequestErrorResourceCountLimitExceededError

คำขอ HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/keywordPlanAdGroups:mutate

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่มีการแก้ไขกลุ่มโฆษณาในแผนคีย์เวิร์ด

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

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

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

object (KeywordPlanAdGroupOperation)

ต้องระบุ รายการการดำเนินการที่จะดำเนินการในแต่ละกลุ่มโฆษณาของแผนคีย์เวิร์ด
partialFailure

boolean

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

boolean

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

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

ข้อความตอบกลับสำหรับการเปลี่ยนแปลงกลุ่มโฆษณาในแผนคีย์เวิร์ด

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

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

object (Status)

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

object (MutateKeywordPlanAdGroupResult)

ผลลัพธ์ทั้งหมดสำหรับการเปลี่ยนแปลง ลำดับของผลลัพธ์จะกำหนดโดยลำดับคำหลักในคำขอเดิม

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

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

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

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