Method: customers.customInterests.mutate

สร้างหรืออัปเดตความสนใจที่กำหนดเอง ระบบจะแสดงสถานะการดำเนินการ

รายการข้อผิดพลาดที่แสดง: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (CustomInterestOperation)

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

boolean

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

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

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

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

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

object (MutateCustomInterestResult)

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

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

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

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

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

CustomInterestOperation

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

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

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

string (FieldMask format)

FieldMask ที่ระบุว่าช่องทรัพยากรใดที่มีการแก้ไขในการอัปเดต

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

object (CustomInterest)

การดำเนินการสร้าง: ต้องไม่มีชื่อทรัพยากรสำหรับความสนใจที่กำหนดเองใหม่
update

object (CustomInterest)

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

MutateCustomInterestResult

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

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

string

แสดงผลเมื่อการดำเนินการสำเร็จ