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.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der GoogleLocations API können Sie im Voraus sehen, ob bereits Anspruch auf einen Standort in Google Unternehmensprofil erhoben wurde. Falls nicht, können Sie umgehend Zugriff darauf anfordern. Wenn Sie Konten verwalten, die im Bulk-Verfahren bestätigt wurden, können Sie potenzielle Übereinstimmungen besser vorab auswählen und vermeiden, dass Standorte doppelt erstellt werden.
Der API-Endpunkt gibt eine URL zurück, die angibt, ob bereits Anspruch auf einen Standort erhoben wurde. Ist das der Fall, können Sie über dieselbe URL den Vorgang für die Zugriffsanfrage starten.
Hier sehen Sie übersichtsartig, wie die Inhaberschaft für einen Standort beantragt wird:
Abbildung 1. Swimlane-Diagramm zum Beantragen der Inhaberschaft von Standorten in Google Unternehmensprofil
Führen Sie folgende Schritte aus, um die GoogleLocations API zu nutzen:
Fordern Sie Standortdaten vom Händler an.
Rufen Sie den Endpunkt googleLocations.search auf. Geben Sie die Standortdaten im Anfragetext des Aufrufs an. Alternativ können Sie sie in einem Abfragestring angeben, ähnlich dem, den Nutzer in die Google Suche oder in Google Maps eingeben, etwa "Starbucks Kurfürstendamm Berlin".
Die API gibt eine Liste mit potenziell übereinstimmenden Standorten und Informationen zu jedem Standort zurück, z. B. locationName und Adresse.
Wählen Sie den Eintrag aus, der Ihrem Standort entspricht. Wenn keine Übereinstimmungen vorhanden sind, rufen Sie accounts.locations.create auf und fahren Sie mit Schritt 5 fort.
Je nachdem, welcher Status in der Antwort für requestAdminRightsUrl zurückgegeben wird, führen Sie die folgenden Aktionen aus:
Wenn requestAdminRightsUrl vorliegt, ist ein anderer Nutzer der Inhaber des Eintrags.
Verweisen Sie den Händler zur URL, damit er darunter eine Anfrage auf Zugriff und Inhaberschaft für den bestehenden Standort in Google Unternehmensprofil stellen kann.
Liegt requestAdminRightsUrl nicht vor, rufen Sie accounts.locations.create auf und erstellen Sie einen neuen Eintrag, der später bestätigt wird.
Wenn Sie im Rahmen dieses Vorgangs neue Einträge erstellt haben, können Sie die Bestätigungs-APIs verwenden, um mit der Bestätigung der Einträge zu beginnen. Weitere Informationen finden Sie unter Bestätigung verwalten.
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eThe GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed.\u003c/p\u003e\n"],["\u003cp\u003eIf a new listing is created, leverage verification APIs to complete the setup process.\u003c/p\u003e\n"],["\u003cp\u003eThis API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis.\u003c/p\u003e\n"]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"],null,["# GoogleLocations\n\nThe GoogleLocations API allows you to see in advance whether a location has been\nclaimed in Business Profile. This way, if the location has been claimed, you can immediately\nrequest access to the location. Also, if you manage bulk-verified accounts, you can more accurately\nselect potential matches in advance and avoid the creation of duplicate locations.\n\nThe API endpoint returns a URL that indicates if a location has already been claimed. If it has\nbeen claimed, the same URL allows you to start the access request process.\n\nThe following image provides an overview of the process to gain ownership of a location.\n**Figure 1.** Swimlane diagram of Business Profile location ownership\n\nThe following steps allow you to use the `GoogleLocations` API:\n\n1. Collect location data from the merchant.\n2. Call the\n [`googleLocations.search`](/my-business/reference/businessinformation/rest/v1/googleLocations)\n endpoint. Provide the location data within the body of the call. Alternatively, you can provide\n it in a query string, similar to what a user would enter in Search or Maps. For example,\n \"Starbucks 5th ave NYC.\"\n\n The API returns a list of potentially matching locations and information about each location,\n such as `locationName` and address.\n3. Select the location that matches your location. If there are no matches, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create), and skip to step 5.\n4. Based on the state of `requestAdminRightsUrl` in the response, take the following\n actions:\n\n 1. If `requestAdminRightsUrl` exists, another user has ownership of the listing. Direct the merchant to the URL to start a request for access and ownership of the existing location in Business Profile.\n 2. If `requestAdminRightsUrl` doesn't exist, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create) and create a new listing that will be verified later.\n5. If you created new listings as part of this process, you can utilize the verification APIs to begin verification of the listings. For more information, see [Manage verification](/my-business/content/manage-verification).\n\n| **Note:** The GoogleLocations API is intended to find the status of locations for which your company has a business relationship with the merchant. The use of the endpoints for the purposes of lead generation or competitive analysis is against [Google's policies](/my-business/content/policies#prohibited_practices) and will result in revocation of API access."]]
