Für die
Google Business Performance API gibt es eine
NEUE API-Methode, mit der sich mehrere „DailyMetrics“-Objekte in einer einzelnen Anfrage abrufen lassen.
Sehen Sie sich den
Zeitplan für die Einstellung und die Anleitung für die Migration von der reportInsights API-Methode Version 4 zur Google Business Profile Performance API an.
Method: accounts.listRecommendGoogleLocations
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hiermit werden alle GoogleLocations aufgelistet, die für das angegebene Unternehmensprofil-Konto empfohlen wurden. Empfehlungen werden nur für private Konten und Standortgruppen gegeben. Anfragen für alle anderen Kontotypen führen zu einem Fehler. Die Empfehlungen für Standortgruppen basieren auf den Standorten in dieser Gruppe.
Die Empfehlungen für private Konten basieren auf allen Standorten, auf die der Nutzer im Unternehmensprofil Zugriff hat. Dazu gehören auch Standorte, auf die er über Standortgruppen zugreifen kann. Sie sind eine Obermenge aller Empfehlungen, die für den Nutzer generiert werden.
HTTP-Anfrage
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Name der Kontoressource, für die empfohlene Google-Standorte abgerufen werden sollen.
|
Abfrageparameter
| Parameter |
pageSize |
integer
Die Anzahl der Standorte, die pro Seite abgerufen werden sollen. Die Standardeinstellung ist 25, die Mindestanzahl ist 1 und die maximale Seitengröße 100.
|
pageToken |
string
Wenn angegeben, wird die nächste Seite mit Standorten abgerufen.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwortnachricht für GoogleLocations.ListrecommendedGoogleLocations.
Er enthält auch einige Standorte, auf die andere Google Unternehmensprofil-Nutzer Anspruch erhoben haben, seitdem sie diesem Unternehmensprofil-Konto das letzte Mal empfohlen wurden.
| JSON-Darstellung |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| Felder |
googleLocations[] |
object (GoogleLocation)
Die für ein Unternehmensprofil-Konto empfohlenen Standorte. Jedes davon repräsentiert eine GoogleLocation, die in Google Maps vorhanden ist. Die Standorte werden in absteigender Reihenfolge nach Relevanz für das Unternehmensprofil-Konto sortiert.
|
totalSize |
integer
Die Gesamtzahl der empfohlenen Standorte für dieses Unternehmensprofil-Konto, unabhängig von der Paginierung.
|
nextPageToken |
string
Wenn bei der Paginierung auf der nächsten Seite weitere Standorte zum Abrufen verfügbar sind, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf die nächste Seite mit Standorten abzurufen. Wenn keine weiteren Standorte zum Abrufen vorhanden sind, ist dieses Feld in der Antwort nicht vorhanden.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
