Method: googleLocations.report
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
网址采用 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.manage
https://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 ,用于说明为什么建议不相关。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\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,["# Method: googleLocations.report\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [BadLocationReason](#BadLocationReason)\n- [BadRecommendationReason](#BadRecommendationReason)\n\nReport a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation).\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of a \\[GoogleLocation\\], in the format `googleLocations/{googleLocationId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"locationGroupName\": string, \"reportReasonElaboration\": string, \"reportReasonLanguageCode\": string, // Union field `report_reason` can be only one of the following: \"reportReasonBadLocation\": enum (/my-business/reference/rest/v4/googleLocations/report#BadLocationReason), \"reportReasonBadRecommendation\": enum (/my-business/reference/rest/v4/googleLocations/report#BadRecommendationReason) // End of list of possible types for union field `report_reason`. } ``` |\n\n| Fields ||\n|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `locationGroupName` | `string` Optional. The resource name of the location group that this Google Location is being reported for, in the format `accounts/{accountId}`. |\n| `reportReasonElaboration` | `string` Optional. A text entry for elaborating on the reason for which the user is reporting this location. The maximum length is 512 characters. |\n| `reportReasonLanguageCode` | `string` Optional. The BCP 47 code of language used in `reportReasonElaboration`. |\n| Union field `report_reason`. Reason why this location is being reported. A reason must be provided. `report_reason` can be only one of the following: |||\n| `reportReasonBadLocation` | `enum (`[BadLocationReason](/my-business/reference/rest/v4/googleLocations/report#BadLocationReason)`)` The reason for which the user is reporting this location when the issue is with the location itself. |\n| `reportReasonBadRecommendation` | `enum (`[BadRecommendationReason](/my-business/reference/rest/v4/googleLocations/report#BadRecommendationReason)`)` The reason for which the user is reporting this location when the issue is with the recommendation. This report is useful if the location has been recommended to the Business Profile account. |\n\n### Response body\n\nIf successful, the response body is empty.\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).\n\nBadLocationReason\n-----------------\n\nA set of possible reasons for reporting a location when there is an issue with the quality of data in the location itself.\n\n| Enums ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `BAD_LOCATION_REASON_UNSPECIFIED` | Not specified. |\n| `NOT_A_LOCATION` | The recommended location is not an actual location. |\n| `PERMANENTLY_CLOSED` | The recommended location is permanently closed. |\n| `DOES_NOT_EXIST` | The recommended location does not exist. |\n| `SPAM` | The recommended location is spam, fake or offensive. |\n| `NOT_A_BUSINESS` | The recommended location is a private place or home. |\n| `MOVED` | The recommended location has moved to a new location. Should be accompanied by a `reportReasonElaboration` specifying the new address. |\n| `DUPLICATE` | The recommended location is a duplicate of another location. |\n\nBadRecommendationReason\n-----------------------\n\nA set of possible reasons for reporting a location when there is an issue with the quality of recommendation (when this location is recommended to the user).\n\n| Enums ||\n|-----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `BAD_RECOMMENDATION_REASON_UNSPECIFIED` | Not specified. |\n| `NOT_A_STORE_FRONT` | The recommended location is not a store front. |\n| `NOT_PART_OF_SUGGESTED_CHAIN` | The recommended location doesn't belong to the chain suggested in the `chainDisplayName` in the returned location. Should be accompanied by a `reportReasonElaboration` specifying the name of the correct chain. |\n| `IRRELEVANT` | The recommended location is not relevant to the user. Should be accompanied by a `reportReasonElaboration` for why the recommendation is irrelevant. |"]]