Method: googleLocations.report
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu HTTP
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
name |
string
Tên tài nguyên của một [GoogleLocation], ở định dạng googleLocations/{googleLocationId}.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng 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.
} |
| Trường |
locationGroupName |
string
Không bắt buộc. Tên tài nguyên của nhóm vị trí mà vị trí này trên Google đang được báo cáo, ở định dạng accounts/{accountId}.
|
reportReasonElaboration |
string
Không bắt buộc. Mục nhập văn bản để giải thích lý do người dùng báo cáo vị trí này. Độ dài tối đa là 512 ký tự.
|
reportReasonLanguageCode |
string
Không bắt buộc. Mã BCP 47 của ngôn ngữ được sử dụng trong reportReasonElaboration.
|
Trường kết hợp report_reason. Lý do vị trí này đang được báo cáo. Bạn phải cung cấp lý do. report_reason chỉ có thể là một trong những trạng thái sau đây: |
reportReasonBadLocation |
enum (BadLocationReason)
Lý do người dùng báo cáo vị trí này khi vấn đề xảy ra với chính vị trí đó.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
Lý do người dùng báo cáo vị trí này khi có vấn đề với đề xuất. Báo cáo này sẽ hữu ích nếu vị trí đã được đề xuất cho tài khoản Trang doanh nghiệp.
|
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ trống.
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
BadLocationReason
Một tập hợp các lý do có thể có để báo cáo một vị trí khi có vấn đề về chất lượng dữ liệu tại chính vị trí đó.
| Enum |
BAD_LOCATION_REASON_UNSPECIFIED |
Chưa chỉ định. |
NOT_A_LOCATION |
Vị trí được đề xuất không phải là vị trí thực tế. |
PERMANENTLY_CLOSED |
Vị trí được đề xuất đã bị đóng vĩnh viễn. |
DOES_NOT_EXIST |
Vị trí được đề xuất không tồn tại. |
SPAM |
Vị trí được đề xuất là spam, giả mạo hoặc xúc phạm. |
NOT_A_BUSINESS |
Vị trí được đề xuất là một địa điểm riêng tư hoặc nhà riêng. |
MOVED |
Vị trí được đề xuất đã chuyển đến một vị trí mới. Phải đi kèm với reportReasonElaboration chỉ định địa chỉ mới. |
DUPLICATE |
Vị trí được đề xuất trùng lặp với một vị trí khác. |
BadRecommendationReason
Một số lý do có thể khiến báo cáo một vị trí khi có vấn đề về chất lượng của nội dung đề xuất (khi vị trí này được đề xuất cho người dùng).
| Enum |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
Chưa chỉ định. |
NOT_A_STORE_FRONT |
Vị trí được đề xuất không phải là mặt tiền của cửa hàng. |
NOT_PART_OF_SUGGESTED_CHAIN |
Vị trí đề xuất không thuộc chuỗi được đề xuất trong chainDisplayName ở vị trí được trả về. Phải đi kèm với reportReasonElaboration chỉ định tên của chuỗi chính xác. |
IRRELEVANT |
Vị trí được đề xuất không liên quan đến người dùng. Phải kèm theo reportReasonElaboration thể hiện lý do khiến đề xuất không liên quan. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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,["# 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. |"]]
