Method: customers.customerManagerLinks.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v15/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. פעולת עדכון בסטטוס 'פעיל' מקבלת הזמנה בהמתנה. 2. פעולת עדכון בסטטוס 'מוזכרת' דוחה הזמנה בהמתנה. 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

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