Method: accounts.locations.patch
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
指定したビジネスを更新します。
Google+ ページがあるビジネスでのみ写真を使用できます。
ビジネスが存在しない場合は NOT_FOUND
を返します。
HTTP リクエスト
PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
name |
string
更新するビジネスの名前です。
|
クエリ パラメータ
パラメータ |
updateMask |
string (FieldMask format)
更新するフィールドです。マスクが指定されていない場合は、完全な更新として処理され、すべてのフィールドは渡された値に設定されます。リクエストに含まれる未設定の空のフィールドもこの対象となる場合があります。 完全修飾フィールド名のカンマ区切りリストです。(例: "user.displayName,photo" )。
|
validateOnly |
boolean
true の場合、ビジネスが実際に更新されることなく、リクエストの検証のみが行われます。
|
attributeMask |
string (FieldMask format)
更新する属性の ID です。マスクで指定した属性のみが更新されます。マスクにのみ含まれ、ビジネスには含まれない属性は削除されます。空のマスクを使用すると、すべての属性が更新されます。 このフィールドを設定するときは常に、updateMask に更新するフィールドの 1 つとして属性を含める必要があります。 完全修飾フィールド名のカンマ区切りリストです。(例: "user.displayName,photo" )。
|
リクエストの本文
リクエストの本文には Location
のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には Location
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
詳細については、OAuth 2.0 の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThis document outlines how to update a specific Google My Business location using the \u003ccode\u003ePATCH\u003c/code\u003e HTTP request method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the location's name in the URL path and can include optional query parameters like \u003ccode\u003eupdateMask\u003c/code\u003e, \u003ccode\u003evalidateOnly\u003c/code\u003e, and \u003ccode\u003eattributeMask\u003c/code\u003e to control the update process.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eLocation\u003c/code\u003e object with the desired updates, and a successful response will return the updated \u003ccode\u003eLocation\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary and requires one of the specified OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003ePhotos can only be added to locations with an associated Google+ page, and attempting to update a non-existent location results in a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error.\u003c/p\u003e\n"]]],["This describes updating a location using a `PATCH` request to the specified URL. The location is identified by its `name` in the path. Updates are controlled by the `updateMask` and `attributeMask` query parameters. A boolean `validateOnly` parameter allows for request validation without making changes. The request and response bodies both use a Location object. Authorization requires specific OAuth scopes. A location must have a Google+ page to be updated with photos, and requests for non-existent locations return `NOT_FOUND`.\n"],null,["# Method: accounts.locations.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 specified location.\n\nPhotos are only allowed on a location that has a Google+ page.\n\nReturns `NOT_FOUND` if the location does not exist.\n\n### HTTP request\n\n`PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------|\n| `name` | `string` The name of the location to update. |\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)` The specific fields to update. If no mask is specified, then this is treated as a full update and all fields are set to the values passed in, which may include unsetting empty fields in the request. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `validateOnly` | `boolean` If true, the request is validated without actually updating the location. |\n| `attributeMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` The IDs of the attributes to update. Only attributes noted in the mask will be updated. If an attribute is present in the mask and not in the location, it will be removed. An empty mask will update all attributes. Whenever this field is set, the updateMask should include attributes as one of the fields to update. 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 [Location](/my-business/reference/rest/v4/accounts.locations#Location).\n\n### Response body\n\nIf successful, the response body contains an instance of [Location](/my-business/reference/rest/v4/accounts.locations#Location).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\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)."]]