Method: customers.accountLinks.mutate

יצירת קישור לחשבון או הסרה שלו. בגרסה 5 אין תמיכה ביצירה דרך AccountLinkService.MutateAccountLink. במקום זאת, צריך להשתמש ב-AccountLinkService.CreateAccountLink.

רשימת השגיאות שהושלחו: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. המזהה של הלקוח שרוצים לשנות.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
שדות
operation

object (AccountLinkOperation)

חובה. הפעולה שרוצים לבצע בקישור.
partialFailure

boolean

אם הערך הוא true, פעולות מוצלחות יבוצעו ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא false, כל הפעולות יבוצעו בעסקה אחת רק אם כולן תקינות. ברירת המחדל היא FALSE.
validateOnly

boolean

אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. המערכת מחזירה רק שגיאות, לא תוצאות.

גוף התשובה

הודעת התגובה עבור שינוי של קישור לחשבון.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
שדות
result

object (MutateAccountLinkResult)

התוצאה של ה-mutate.
partialFailureError

object (Status)

שגיאות שקשורות לכשלים בפעולות במצב של כשל חלקי. הפונקציה מחזירה את הערך הזה רק אם partialFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם יצוצו שגיאות מחוץ לפעולות (לדוגמה, שגיאות אימות), אנחנו מחזירים שגיאה ברמת ה-RPC.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

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

מידע נוסף זמין בOAuth 2.0 Overview.

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

הקוד מוחזר עבור פעולות שהסתיימו בהצלחה.