Method: customers.customerManagerLinks.mutate

מעדכנות קישורים של מנהלי לקוחות. הסטטוסים של הפעולות מוחזרים.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customerId

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
שדות
operations[]

object (CustomerManagerLinkOperation)

חובה. רשימת הפעולות שצריך לבצע בקישורים נפרדים של מנהלי לקוחות.
validateOnly

boolean

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

גוף התשובה

הודעת תגובה לשינוי של CustomerManagerLink.

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

ייצוג JSON 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
שדות
results[]

object (MutateCustomerManagerLinkResult)

תוצאה שמזהה את המשאב שמושפע מבקשת השינוי.

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

CustomerManagerLinkOperation

עדכון הסטטוס של CustomerManagerLink. אלה הפעולות האפשריות: 1. פעולת עדכון בסטטוס ACTIVE מקבלת הזמנה בהמתנה. 2. פעולת עדכון עם הסטטוס REFUSED דוחה הזמנה בהמתנה. 3. פעולת עדכון בסטטוס 'לא פעיל' מסיימת את הקישור למנהל.

ייצוג JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerManagerLink)
  }
  // End of list of possible types for union field operation.
}
שדות
updateMask

string (FieldMask format)

FieldMask קובעת אילו שדות משאבים ישונו בעדכון.

זוהי רשימה מופרדת בפסיקים של שמות מלאים של שדות. דוגמה: "user.displayName,photo"
שדה איחוד operation. פעולת השינוי. operation יכול להיות רק אחד מהבאים:
update

object (CustomerManagerLink)

פעולת עדכון: אמור להיות לקישור שם משאב חוקי.

MutateCustomerManagerLinkResult

התוצאה של שינוי הקישור של מנהל הלקוחות.

ייצוג JSON 
{
  "resourceName": string
}
שדות
resourceName

string

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