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

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

boolean

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

גוף התשובה

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

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

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

object (MutateAccountLinkResult)

תוצאה עבור השינוי.
partialFailureError

object (Status)

שגיאות שקשורות לכשלים בפעולה במצב כשל חלקי. הפונקציה מוחזרת רק כאשר PartFailure = 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

מוחזר עבור פעולות שבוצעו בהצלחה.