Mit Standortdaten arbeiten

In dieser Anleitung erfahren Sie, wie Sie Standortdaten erstellen und bearbeiten. Mit der My Business Business Information API haben Sie folgende Möglichkeiten:

• Neuen Standort erstellen
• Standort löschen
• Standort anhand des Ressourcennamens abrufen
• Alle Standorte für ein Konto auflisten
• Ein 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. Standortdaten werden durch die Sammlung accounts.locations dargestellt.

Hinweis

Bevor Sie die My Business Business Information API verwenden können, müssen Sie Ihre Anwendung registrieren und OAuth 2.0-Anmeldedaten abrufen. Weitere Informationen zu den ersten Schritten mit der My Business Business Information API finden Sie unter Grundlegende Einrichtung.

Standort erstellen

Mit der My Business Business Information API können Sie mit accounts.locations.create 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 verwenden, um einen Standort mit locations.delete zu löschen.

So löschen Sie einen Standort:

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

Standort anhand des Namens abrufen

Wenn viele Unternehmen mit Ihrem Konto verknüpft sind, möchten Sie möglicherweise einen einzelnen Standort abrufen. Sie können nach dem Namen des Unternehmens filtern, um mit locations.get einen bestimmten Standort abzurufen.

Verwenden Sie folgenden Code, um einen Standort anhand des Namens abzurufen. Sie müssen „readMask“ 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 dazu, wie Sie Google-Updates verwalten, finden Sie hier.

Speicherorte auflisten

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

So listen Sie alle Standorte auf, die einem authentifizierten Nutzer direkt gehören oder von diesem direkt 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 Einträge mit indirekter Inhaberschaft einzubeziehen (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

Eine Einschränkung hat die folgende Syntax: <field><operator><value>, wobei der Operator entweder EQUALS (=) oder HAS (:) ist. Die Operatoren EQUALS (=) und HAS (:) sind für alle Felder außer locationName äquivalent (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. „4 drive“ würde z. B. mit „4, Liguster Drive“ übereinstimmen.

Mehrere Felder in einer Filterabfrage kombinieren

Die API ermöglicht das Verbinden aller Feldeinschränkungen mit UND. Beim Keyword OR müssen jedoch alle Einschränkungen für dasselbe Feld gelten. Beispiel: locationName=A OR labels=B ist nicht zulässig.

Beispiel

Das folgende Beispiel zeigt einen Filterausdruck, mit dem alle Standorte mit dem Namen „Pepé Le Pew“ zurückgegeben werden. 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

Nach Entfernung oder Konto suchen

Das folgende Beispiel zeigt, 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

Im Folgenden 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

Verwenden Sie die My Business Business Information API, um ein oder mehrere Felder für einen Standort mit locations.patch zu aktualisieren.

Verwenden Sie folgenden Code, um ein 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"
}