Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: googleLocations.report
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
[GoogleLocation]의 리소스 이름으로, googleLocations/{googleLocationId} 형식입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| JSON 표현 |
{
"locationGroupName": string,
"reportReasonElaboration": string,
"reportReasonLanguageCode": string,
// Union field report_reason can be only one of the following:
"reportReasonBadLocation": enum (BadLocationReason),
"reportReasonBadRecommendation": enum (BadRecommendationReason)
// End of list of possible types for union field report_reason.
} |
| 필드 |
locationGroupName |
string
선택사항입니다. 이 Google 위치가 보고되는 위치 그룹의 리소스 이름으로, accounts/{accountId} 형식입니다.
|
reportReasonElaboration |
string
선택사항입니다. 사용자가 이 위치를 신고하는 이유를 자세히 설명하기 위한 텍스트 항목입니다. 최대 길이는 512자(영문 기준)입니다.
|
reportReasonLanguageCode |
string
선택사항입니다. reportReasonElaboration에서 사용되는 BCP 47 언어 코드입니다.
|
통합 필드 report_reason. 이 위치가 보고되는 이유입니다. 이유를 입력해야 합니다. report_reason은 다음 중 하나여야 합니다. |
reportReasonBadLocation |
enum (BadLocationReason)
위치 자체에 문제가 있는 경우 사용자가 이 위치를 신고하는 이유입니다.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
추천에 문제가 있을 때 사용자가 이 위치를 신고하는 이유입니다. 이 보고서는 위치가 비즈니스 프로필 계정에 추천된 경우 유용합니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 개요를 참고하세요.
BadLocationReason
위치 자체의 데이터 품질에 문제가 있는 경우 위치를 보고하는 일련의 가능한 이유입니다.
| 열거형 |
BAD_LOCATION_REASON_UNSPECIFIED |
지정되지 않음 |
NOT_A_LOCATION |
추천 위치는 실제 위치가 아닙니다. |
PERMANENTLY_CLOSED |
추천 위치가 폐업했습니다. |
DOES_NOT_EXIST |
추천 위치가 없습니다. |
SPAM |
추천 위치는 스팸, 가짜 또는 불쾌감을 주는 위치입니다. |
NOT_A_BUSINESS |
권장되는 위치는 비공개 장소 또는 집입니다. |
MOVED |
추천 위치가 새 위치로 이전되었습니다. 새 주소를 지정하는 reportReasonElaboration가 함께 제공되어야 합니다. |
DUPLICATE |
추천 위치가 다른 위치와 중복됩니다. |
BadRecommendationReason
추천 품질에 문제가 있는 경우 (위치가 사용자에게 추천된 경우) 위치를 신고하는 가능한 이유입니다.
| 열거형 |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
지정되지 않음 |
NOT_A_STORE_FRONT |
권장 위치가 매장이 아닙니다. |
NOT_PART_OF_SUGGESTED_CHAIN |
추천 위치가 반환된 위치의 chainDisplayName에서 제안된 체인에 속하지 않습니다. 올바른 체인의 이름을 지정하는 reportReasonElaboration가 함께 제공되어야 합니다. |
IRRELEVANT |
추천 위치가 사용자와 관련이 없습니다. 권장사항이 관련이 없는 이유에 관한 reportReasonElaboration가 함께 제공되어야 합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eReport a Google Location using the \u003ccode\u003egoogleLocations/{googleLocationId}\u003c/code\u003e resource name and specifying the report reason.\u003c/p\u003e\n"],["\u003cp\u003eProvide optional details like \u003ccode\u003elocationGroupName\u003c/code\u003e, \u003ccode\u003ereportReasonElaboration\u003c/code\u003e, and \u003ccode\u003ereportReasonLanguageCode\u003c/code\u003e for better context.\u003c/p\u003e\n"],["\u003cp\u003eReport reasons can be categorized as either related to the location itself (\u003ccode\u003eBadLocationReason\u003c/code\u003e) or to the recommendation (\u003ccode\u003eBadRecommendationReason\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a JSON payload with details about the report, and a successful response results in an empty body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using either the \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],["To report a Google Location, send a POST request to `https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report`, where `name` is the location's resource name. The request body should include `locationGroupName`, `reportReasonElaboration`, `reportReasonLanguageCode`, and a `report_reason`. The `report_reason` is either a `reportReasonBadLocation` or `reportReasonBadRecommendation` enum. Response body will be empty. This action requires `plus.business.manage` or `business.manage` OAuth scopes.\n"],null,[]]
