Method: customers.accountLinks.mutate

สร้างหรือนำการลิงก์บัญชีออก จาก V5 ไม่รองรับการสร้างผ่าน AccountLinkService.MutateAccountLink โปรดใช้ AccountLinkService.CreateAccountLink แทน

รายการข้อผิดพลาดที่ปรากฏ: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

คำขอ HTTP

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

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่กำลังแก้ไข

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

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

การแสดง JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
ช่อง
operation

object (AccountLinkOperation)

ต้องระบุ การดําเนินการที่ดําเนินการกับลิงก์
partialFailure

boolean

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

boolean

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

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

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

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

การแสดง JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
ช่อง
result

object (MutateAccountLinkResult)

ผลลัพธ์ของการเปลี่ยนแปลง
partialFailureError

object (Status)

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

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

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

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

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

AccountLinkOperation

การอัปเดตรายการเดียวสำหรับลิงก์บัญชี

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

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

string (FieldMask format)

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

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

object (AccountLink)

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

string

การนำการดำเนินการออก: ควรมีชื่อทรัพยากรสำหรับลิงก์บัญชีที่จะนำออกในรูปแบบต่อไปนี้

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

ผลลัพธ์ของการเปลี่ยนรูปแบบการลิงก์บัญชี

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

string

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