Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
Method: locations.admins.patch
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新指定位置的管理員。只有管理員的管理員角色可以更新。
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)
必要欄位。要更新的特定欄位。唯一可編輯的欄位是角色。 此為以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
|
回應主體
如果成功，回應主體會包含 Admin 的執行例項。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：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)."]]
