Method: customers.keywordPlans.mutate

สร้าง อัปเดต หรือนำแผนคีย์เวิร์ดออก ระบบจะแสดงสถานะการดำเนินการ

รายการข้อผิดพลาด: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestErrorResourceCountLimitExceededErrorStringLengthError

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (KeywordPlanOperation)

ต้องระบุ รายการการดำเนินการที่จะทำกับแต่ละแผนคีย์เวิร์ด
partialFailure

boolean

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

boolean

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

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

ข้อความตอบกลับสําหรับการเปลี่ยนแปลงแผนคีย์เวิร์ด

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

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

object (Status)

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

object (MutateKeywordPlansResult)

ผลลัพธ์ทั้งหมดของการเปลี่ยน

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

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

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

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