Method: locations.admins.patch
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新指定营业地点的管理员。只能更新 Admin 的 AdminRole。
HTTP 请求
PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{locationAdmin.name=locations/*/admins/*}
网址采用 gRPC 转码语法。
路径参数
参数 |
locationAdmin.name |
string
不可变。资源名称。 对于账号管理员,其格式为:accounts/{account_id}/admins/{admin_id} 对于营业地点管理员,其格式为:locations/{locationId}/admins/{admin_id} 如果在管理员创建期间设置了此字段,则会被忽略。
|
查询参数
参数 |
updateMask |
string (FieldMask format)
必需。应更新的特定字段。唯一可修改的字段是“role”(角色)。 这是以逗号分隔的完全限定字段名称列表。示例:"user.displayName,photo" 。
|
响应正文
如果成功,则响应正文包含一个 Admin
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/business.manage
有关详情,请参阅 OAuth 2.0 概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\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)."]]