Method: customers.customerUserAccesses.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerUserAccesses:mutate

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

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

פרמטרים
customerId

string

חובה. מספר הלקוח שמשתנה.

גוף הבקשה

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

ייצוג JSON 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
שדות
operation

object (CustomerUserAccessOperation)

חובה. הפעולה שצריך לבצע אצל הלקוח

גוף התגובה

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

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

ייצוג JSON 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
שדות
result

object (MutateCustomerUserAccessResult)

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

היקפי הרשאות

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

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

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

CustomerUserAccessOperation

פעולה יחידה (עדכון, הסרה) בגישת משתמש של לקוח.

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

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

string (FieldMask format)

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

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

object (CustomerUserAccess)

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

string

פעולת הסרה: יש להזין שם משאב לגישה שהוסרה, בפורמט הבא:

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

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

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

string

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