Method: customers.accountLinks.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/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

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