Mit Standortdaten arbeiten

In diesem Tutorial erfahren Sie, wie Sie Standortdaten erstellen und bearbeiten. Die My Business Business Information API bietet Ihnen folgende Möglichkeiten:

• Einen neuen Standort erstellen
• Einen Standort löschen
• Einen Standort anhand des Ressourcennamens abrufen
• Alle Standorte für ein Konto auflisten
• Ein Feld oder mehrere Felder für einen Standort aktualisieren

Standorte können in Anzeigen verwendet werden, müssen aber bestätigt werden, damit sie in der Google Suche und auf Google Maps erscheinen können. Für Standortdaten werden die Felder von accounts.locations verwendet.

Hinweis

Sie können die My Business Business Information API erst verwenden, nachdem Sie Ihre Anwendung registriert und OAuth 2.0-Anmeldedaten abgerufen haben. Weitere Informationen zu den ersten Schritten mit der My Business Business Information API finden Sie unter Grundlegende Einrichtung.

Standort erstellen

Anhand von accounts.locations.create können Sie mit der My Business Business Information API einen neuen Standort für ein Unternehmen erstellen.

Verwenden Sie folgenden Code, um einen Standort zu erstellen:

POST
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?requestId=requestId&validateOnly=True|False

{
    "storeCode": "GOOG-SYD",
    "languageCode": "en-AU",
    "title": "Google Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
     }
    "storefrontAddress": {
      "addressLines": [
        "Level 5",
        "48 Pirrama Road"
      ],
      "locality": "Pyrmont",
      "postalCode": "2009",
      "administrativeArea": "NSW",
      "regionCode": "AU"
    },
    "websiteUri": "https://www.google.com.au/",
    "regularHours": {
      "periods": [
        {
          "openDay": "MONDAY",
          "closeDay": "MONDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "TUESDAY",
          "closeDay": "TUESDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "WEDNESDAY",
          "closeDay": "WEDNESDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "THURSDAY",
          "closeDay": "THURSDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        },
        {
          "openDay": "FRIDAY",
          "closeDay": "FRIDAY",
          "openTime": "09:00",
          "closeTime": "17:00"
        }
      ]
    },
    "categories": {
      "primaryCategory": {
        "name": "gcid:software_company"
      }
     }
}

Standort löschen

Sie können die My Business Business Information API nutzen, um einen Standort mit locations.delete zu löschen.

Verwenden Sie folgenden Code, um einen Standort zu löschen:

DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

Standort anhand des Namens abrufen

Mit Ihrem Konto sind viele Unternehmen verknüpft? Dann möchten Sie unter Umständen einen bestimmten Standort abrufen. Sie können nach dem Namen des Unternehmens filtern, um einen bestimmten Standort mit locations.get abzurufen.

Verwenden Sie folgenden Code, um einen Standort anhand seines Namens abzurufen. Sie müssen einen „readMask“-Parameter angeben, um bestimmte Felder abzurufen. :

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask={commaSeparatedFieldsToRetrieve}

Google Maps-Version zurückgeben

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated?readMask={commaSeparatedFieldsToRetrieve}

Wenn keine Ergebnisse vorhanden sind, wird der HTTP-Statuscode 404 NOT FOUND zurückgegeben. Weitere Informationen zur Verwaltung von Google-Updates finden Sie hier.

Standorte auflisten

Wenn Sie einen Standort oder mehrere Standorte verwalten, können Sie auch sämtliche Standorte auflisten, die mit Ihrem Konto verknüpft sind. Mit der accounts.locations.list API listen Sie alle Standorte auf, die einem Nutzer zugeordnet sind.

So listen Sie alle Standorte auf, deren Inhaber ein authentifizierter Nutzer ist oder die direkt von einem authentifizierten Nutzer verwaltet werden:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}

Verwenden Sie für das Konto in der Anfrage-URL den Platzhalter '-', um auch Einträge aufzunehmen, die indirekt einem Nutzer gehören (Inhaberschaft oder Verwaltung über eine Gruppe):

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/-/locations?readMask={commaSeparatedFieldsToRetrieve}

Ergebnisse beim Auflisten von Standorten filtern

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter={FIELD_NAME}=%22{YOUR_QUERY}%22

Einfache Abfragesyntax

Einschränkungen haben die Syntax <field><operator><value>, wobei der Operator entweder EQUALS (=) oder HAS (:) lautet. Die Operatoren EQUALS (=) und HAS (:) bewirken in allen Feldern außer locationName das Gleiche (siehe Tabelle unten).

Anführungszeichen werden als „%22“ und Leerzeichen als Pluszeichen (+) codiert.

Sofern nicht anders angegeben, sind alle Vergleiche Tokenvergleiche, bei denen die Groß-/Kleinschreibung nicht berücksichtigt wird. So wird beispielsweise „4 drive“ genau wie „4, Privet Drive“ behandelt.

Mehrere Felder in einer Filterabfrage kombinieren

Über die API können alle Feldeinschränkungen mit AND verbunden werden. Bei OR müssen sich aber alle Einschränkungen auf dasselbe Feld beziehen. Zum Beispiel ist locationName=A OR labels=B nicht zulässig.

Beispiel

Im folgenden Beispiel sehen Sie einen Filterausdruck, der alle Standorte mit dem Namen „Pepé Le Pew“ zurückgibt. Es werden Kategorien für „french_restaurant“ oder „european_restaurant“ und das Label „newly open“ angezeigt.

locationName=%22Pepé+Le+Pew%22+AND+
(categories=%22french_restaurant%22+OR+
categories=%22european_restaurant%22)+AND+
labels=%22newly+open%22

Suche nach Entfernung oder Konto

Im folgenden Beispiel sehen Sie, wie Sie nach Standorten innerhalb einer bestimmten Entfernung von einem geografischen Punkt suchen können:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter=distance(latlng, geopoint({latitude}, {longitude}))<{distance}

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&filter=distance(latlng, geopoint(40.01, -105.27))<1000.0

Liste aller unterstützten Filterfelder

Nachfolgend finden Sie eine vollständige Liste aller Felder, die zum Filtern verwendet werden können:

Nach Abfragefeld sortieren

Sie können die Ergebnisse in aufsteigender oder absteigender Reihenfolge nach dem Namen des Unternehmens oder dem Geschäftscode sortieren. Mehrere Sortierkriterien werden im orderBy-String durch Kommas getrennt, wie im folgenden Beispiel gezeigt:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}&orderBy=locationName,storeCode

Standort korrigieren

Sie können die My Business Business Information API verwenden, um ein Feld oder mehrere Felder für einen Standort mit locations.patch zu aktualisieren.

Gehen Sie folgendermaßen vor, um ein Feld oder mehrere Felder für einen Standort zu ändern:

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?languageCode=language&validateOnly=True|False&updateMask=title
{
    "title": "Google Shoes"
}