Interfejs
Google Business Performance API udostępnia
NOWĄ metodę interfejsu API, która umożliwia pobieranie wielu parametrów „DailyMetrics” w jednym żądaniu API.
Zapoznaj się z
harmonogramem wycofywania i instrukcjami, jak przejść z metody raportu API w wersji 4 na interfejs Google Business Profile Performance API.
Method: googleLocations.report
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Żądanie HTTP
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
name |
string
Nazwa zasobu [GoogleLocation] w formacie googleLocations/{googleLocationId}.
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis 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.
} |
| Pola |
locationGroupName |
string
Opcjonalnie: Nazwa zasobu grupy lokalizacji, dla której raportowana jest ta lokalizacja Google, w formacie accounts/{accountId}.
|
reportReasonElaboration |
string
Opcjonalnie: Wpis tekstowy wyjaśniający przyczynę, dla której użytkownik zgłasza tę lokalizację. Maksymalna długość to 512 znaków.
|
reportReasonLanguageCode |
string
Opcjonalnie: Kod języka BCP 47 używany w języku: reportReasonElaboration.
|
Pole sumy report_reason. Powód, dla którego ta lokalizacja została zgłoszona. Należy podać powód. report_reason może mieć tylko jedną z tych wartości: |
reportReasonBadLocation |
enum (BadLocationReason)
Powód, dla którego użytkownik zgłasza tę lokalizację, jeśli problem dotyczy samej lokalizacji.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
Powód, dla którego użytkownik zgłasza tę lokalizację, gdy problem jest związany z rekomendacją. Ten raport jest przydatny, jeśli lokalizacja została zarekomendowana kontu w Profilu Firmy.
|
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie pusta.
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
BadLocationReason
Zestaw możliwych przyczyn zgłaszania lokalizacji w przypadku problemu z jakością danych w samej lokalizacji.
| Wartości w polu enum |
BAD_LOCATION_REASON_UNSPECIFIED |
Nie określono. |
NOT_A_LOCATION |
Zalecana lokalizacja nie jest rzeczywistą lokalizacją. |
PERMANENTLY_CLOSED |
Zalecana lokalizacja jest zamknięta na stałe. |
DOES_NOT_EXIST |
Zalecana lokalizacja nie istnieje. |
SPAM |
Zalecana lokalizacja to spam, fałszywa lub obraźliwa lokalizacja. |
NOT_A_BUSINESS |
Zalecana lokalizacja to prywatne miejsce lub dom. |
MOVED |
Zalecana lokalizacja została przeniesiona do nowej lokalizacji. Powinien zostać dołączony do dokumentu reportReasonElaboration, który określa nowy adres. |
DUPLICATE |
Zalecana lokalizacja jest duplikatem innej lokalizacji. |
BadRecommendationReason
Zestaw możliwych przyczyn zgłaszania lokalizacji w przypadku problemów z jakością rekomendacji (gdy dana lokalizacja jest rekomendowana użytkownikowi).
| Wartości w polu enum |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
Nie określono. |
NOT_A_STORE_FRONT |
Zalecana lokalizacja nie jest witryną sklepową. |
NOT_PART_OF_SUGGESTED_CHAIN |
Zalecana lokalizacja nie należy do łańcucha sugerowanego w polu chainDisplayName w zwróconej lokalizacji. Powinien mu towarzyszyć atrybut reportReasonElaboration z nazwą prawidłowego łańcucha. |
IRRELEVANT |
Zalecana lokalizacja nie pasuje do użytkownika. Aby dowiedzieć się, dlaczego rekomendacja jest nietrafna, powinna zostać uzupełniona o reportReasonElaboration. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
