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: accounts.listRecommendGoogleLocations
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wymień wszystkie GoogleLocation, które zostały zalecane w przypadku określonego konta w Profilu Firmy. Rekomendacje są podawane tylko w przypadku kont osobistych i grup lokalizacji. Żądania dotyczące wszystkich innych typów kont będą powodować błąd. Rekomendacje dotyczące grup lokalizacji są tworzone na podstawie lokalizacji w tej grupie.
Rekomendacje dotyczące kont osobistych są oparte na wszystkich lokalizacjach, do których użytkownik ma dostęp w profilu firmy (obejmuje to lokalizacje, do których ma dostęp za pomocą grup lokalizacji), i stanowi element nadrzędny wszystkich rekomendacji wygenerowanych dla tego użytkownika.
Żądanie HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
name |
string
Nazwa zasobu konta, dla którego mają zostać pobrane zalecane lokalizacje Google.
|
Parametry zapytania
| Parametry |
pageSize |
integer
Liczba lokalizacji do pobrania na stronę. Wartość domyślna to 25, minimalna 1, a maksymalna – 100.
|
pageToken |
string
Jeśli określisz wartość, zostanie pobrana następna strona lokalizacji.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Komunikat z odpowiedzią na temat GoogleLocations.List RecommendedGoogleLocations.
Zawiera też lokalizacje, do których inni użytkownicy Profilu Firmy zgłosili prawa od czasu ostatniej rekomendacji ich na tym koncie w Profilu Firmy.
| Zapis JSON |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| Pola |
googleLocations[] |
object (GoogleLocation)
Lokalizacje zalecane dla konta w Profilu Firmy. Każdy z nich odpowiada atrybutowi GoogleLocation obecnemu w Mapach. Lokalizacje są posortowane w kolejności malejącej trafności względem konta w usłudze Profil Firmy.
|
totalSize |
integer
Łączna liczba zalecanych lokalizacji w przypadku tego konta w Profilu Firmy bez względu na podział na strony.
|
nextPageToken |
string
Jeśli podczas dzielenia na strony dostępne są więcej lokalizacji do pobrania na następnej stronie, pole to jest zapełniane tokenem umożliwiającym pobranie następnej strony lokalizacji w kolejnym wywołaniu. Jeśli nie ma więcej lokalizacji do pobrania, oznacza to, że w odpowiedzi nie ma tego pola.
|
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.
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\u003eLists recommended Google Locations for a specified Business Profile account, suitable for personal accounts and location groups.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are based on locations the user has access to and are sorted by relevance.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes location details, total recommendations, and pagination token for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Business Profile management.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listRecommendGoogleLocations\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRecommendedGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList all the [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)s that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group.\n\nThe recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------|\n| `name` | `string` Name of the account resource to fetch recommended Google locations for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of locations is retrieved. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for GoogleLocations.ListRecommendedGoogleLocations.\n\nIt also contains some locations that have been claimed by other Business Profile users since the last time they were recommended to this Business Profile account.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` The locations recommended to a Business Profile account. Each of these represents a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation) that is present on Maps. The locations are sorted in decreasing order of relevance to the Business Profile account. |\n| `totalSize` | `integer` The total number of recommended locations for this Business Profile account, irrespective of pagination. |\n| `nextPageToken` | `string` During pagination, if there are more locations available to be fetched in the next page, this field is populated with a token to fetch the next page of locations in a subsequent call. If there are no more locations to be fetched, this field is not present in the response. |\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)."]]
