A API
Google Business Performance tem um
NOVO método de API que permite buscar várias "DailyMetrics" em uma única solicitação de API.
Confira a
programação de descontinuação e instruções para migrar do método de API reportInsights v4 para a API Google Business Profile Performance.
Method: googleLocations.report
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Solicitação HTTP
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
name |
string
Nome de recurso de um [GoogleLocation], no formato googleLocations/{googleLocationId}.
|
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
| Representação 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.
} |
| Campos |
locationGroupName |
string
Opcional. O nome do recurso do grupo de locais para o qual esse local do Google está sendo informado, no formato accounts/{accountId}.
|
reportReasonElaboration |
string
Opcional. Uma entrada de texto para explicar o motivo pelo qual o usuário está informando esse local. O tamanho máximo é de 512 caracteres.
|
reportReasonLanguageCode |
string
Opcional. O código de idioma BCP 47 usado em reportReasonElaboration.
|
Campo de união report_reason. Motivo pelo qual esse local está sendo informado. É necessário fornecer um motivo. report_reason pode ser apenas de um dos tipos a seguir: |
reportReasonBadLocation |
enum (BadLocationReason)
É o motivo pelo qual o usuário está informando esse local quando o problema está relacionado ao próprio local.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
É o motivo pelo qual o usuário está informando esse local quando o problema está na recomendação. Esse relatório será útil se o local tiver sido recomendado para a conta do Perfil da Empresa.
|
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta estará vazio.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Para mais informações, consulte a Visão geral do OAuth 2.0.
BadLocationReason
Um conjunto de possíveis motivos para informar um local quando há um problema com a qualidade dos dados no próprio local.
| Enums |
BAD_LOCATION_REASON_UNSPECIFIED |
Não especificado. |
NOT_A_LOCATION |
O local recomendado não é um local real. |
PERMANENTLY_CLOSED |
O local recomendado está permanentemente fechado. |
DOES_NOT_EXIST |
O local recomendado não existe. |
SPAM |
O local recomendado é spam, falso ou ofensivo. |
NOT_A_BUSINESS |
O local recomendado é uma casa ou um lugar particular. |
MOVED |
O local recomendado mudou para um novo local. Precisa vir acompanhado de um reportReasonElaboration especificando o novo endereço. |
DUPLICATE |
O local recomendado é uma duplicata de outro local. |
BadRecommendationReason
Um conjunto de possíveis motivos para informar um local quando há um problema com a qualidade da recomendação (quando esse local é recomendado ao usuário).
| Enums |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
Não especificado. |
NOT_A_STORE_FRONT |
O local recomendado não é uma vitrine. |
NOT_PART_OF_SUGGESTED_CHAIN |
O local recomendado não pertence à rede sugerida no chainDisplayName do local retornado. Precisa vir acompanhado de um reportReasonElaboration especificando o nome da cadeia correta. |
IRRELEVANT |
O local recomendado não é relevante para o usuário. Deve ser acompanhado por um reportReasonElaboration para indicar por que a recomendação é irrelevante. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 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. |"]]
