Method: locations.admins.patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
עדכון האדמין למיקום שצוין. ניתן לעדכן רק את תפקיד האדמין של האדמין.
בקשת HTTP
PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{locationAdmin.name=locations/*/admins/*}
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים |
locationAdmin.name |
string
לא משתנה. שם המשאב עבור מנהלי חשבונות, זהו הטופס הבא: accounts/{account_id}/admins/{admin_id} עבור אדמינים של מיקומים, הטופס הזה יהיה בפורמט הבא: locations/{locationId}/admins/{admin_id} המערכת תתעלם מהשדה הזה אם הוא יוגדר במהלך יצירת האדמין.
|
פרמטרים של שאילתה
| פרמטרים |
updateMask |
string (FieldMask format)
חובה. השדות הספציפיים שצריך לעדכן. השדה היחיד שניתן לעריכה הוא תפקיד. זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
|
גוף הבקשה
גוף הבקשה מכיל מופע של Admin.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Admin.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/business.manage
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eThis document details the \u003ccode\u003ePATCH\u003c/code\u003e request to update an Admin for a specific location within a Google My Business account.\u003c/p\u003e\n"],["\u003cp\u003eOnly the AdminRole of the Admin can be updated using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization using the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eBoth the request and response bodies utilize the \u003ccode\u003eAdmin\u003c/code\u003e object for data transfer.\u003c/p\u003e\n"],["\u003cp\u003eLocation admins are identified using the \u003ccode\u003elocations/{locationId}/admins/{admin_id}\u003c/code\u003e path parameter format.\u003c/p\u003e\n"]]],["This documentation outlines how to update an Admin for a specified location via a PATCH request to the given URL. The `locationAdmin.name` path parameter identifies the admin to be updated. The `updateMask` query parameter specifies the field to modify, with only the admin's role being editable. The request body must contain an Admin instance, and the response body also returns an Admin instance if successful. The operation requires the `business.manage` OAuth scope for authorization.\n"],null,["# Method: locations.admins.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nUpdates the Admin for the specified location. Only the AdminRole of the Admin can be updated.\n\n### HTTP request\n\n`PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{locationAdmin.name=locations/*/admins/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `locationAdmin.name` | `string` Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{locationId}/admins/{admin_id}` This field will be ignored if set during admin creation. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields that should be updated. The only editable field is role. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Admin](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin).\n\n### Response body\n\nIf successful, the response body contains an instance of [Admin](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
