Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: accounts.locations.patch
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 위치를 업데이트합니다.
사진은 Google+ 페이지가 있는 위치에만 허용됩니다.
위치가 없는 경우 NOT_FOUND를 반환합니다.
HTTP 요청
PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
업데이트할 위치의 이름입니다.
|
쿼리 매개변수
| 매개변수 |
updateMask |
string (FieldMask format)
업데이트할 특정 필드입니다. 마스크를 지정하지 않으면 전체 업데이트로 처리되며 모든 필드가 전달된 값으로 설정됩니다. 여기에는 요청에서 빈 필드의 설정 해제가 포함될 수 있습니다. 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"
|
validateOnly |
boolean
true인 경우 실제로 위치를 업데이트하지 않고 요청의 유효성이 검사됩니다.
|
attributeMask |
string (FieldMask format)
업데이트할 속성의 ID입니다. 마스크에 명시된 속성만 업데이트됩니다. 마스크에는 있고 위치에는 없는 속성은 삭제됩니다. 마스크가 비어 있으면 모든 속성이 업데이트됩니다. 이 필드가 설정될 때마다 updateMask는 속성을 업데이트할 필드 중 하나로 포함해야 합니다. 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"
|
요청 본문
요청 본문에는 Location의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 Location의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]
