Method: customers.customAudiences.mutate

สร้างหรืออัปเดตกลุ่มเป้าหมายที่กำหนดเอง ระบบจะแสดงผลสถานะการดำเนินการ

รายการข้อผิดพลาดแบบโยน: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorQuotaErrorRequestError

คำขอ HTTP

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

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่มีการแก้ไขกลุ่มเป้าหมายที่กำหนดเอง

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

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

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

object (CustomAudienceOperation)

ต้องระบุ รายการการดำเนินการที่จะดำเนินการในกลุ่มเป้าหมายที่กำหนดเองแต่ละรายการ
validateOnly

boolean

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

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

ข้อความตอบกลับสำหรับการเปลี่ยนแปลงกลุ่มเป้าหมายที่กำหนดเอง

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

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

object (MutateCustomAudienceResult)

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

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

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

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

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

CustomAudienceOperation

การดำเนินการเดียว (สร้าง อัปเดต) ในกลุ่มเป้าหมายที่กำหนดเอง

การแสดง JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomAudience)
  },
  "update": {
    object (CustomAudience)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
ช่อง
updateMask

string (FieldMask format)

FieldMask ที่กำหนดว่าจะมีการแก้ไขฟิลด์ทรัพยากรใดในการอัปเดต

ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองซึ่งคั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
ฟิลด์สหภาพ operation การดำเนินการเปลี่ยนแปลง operation ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
create

object (CustomAudience)

การดำเนินการสร้าง: กลุ่มเป้าหมายใหม่ที่กำหนดเองจะไม่มีชื่อทรัพยากร
update

object (CustomAudience)

การดำเนินการอัปเดต: กลุ่มเป้าหมายที่กำหนดเองควรมีชื่อทรัพยากรที่ถูกต้อง
remove

string

การนำการดำเนินการออก: ควรมีชื่อทรัพยากรของกลุ่มเป้าหมายที่กำหนดเองซึ่งนำออกแล้วในรูปแบบต่อไปนี้

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

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

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

string

แสดงผลสำหรับการดำเนินการที่ประสบความสำเร็จ