REST Resource: locations

Ressource: Location

Ein Standort. Eine ausführliche Beschreibung dieser Felder finden Sie in diesem Hilfeartikel. Unter Kategorieendpunkt finden Sie eine Liste gültiger Unternehmenskategorien.

JSON-Darstellung 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Felder
name

string

Google-ID für diesen Standort im Format locations/{locationId}.
languageCode

string

Nicht veränderbar. Die Sprache des Standorts. Wird während der Erstellung festgelegt und kann nicht aktualisiert werden.
storeCode

string

Optional. Externe Kennung für diesen Standort, die innerhalb eines Kontos eindeutig sein muss. Dies ist eine Möglichkeit, den Standort mit Ihren eigenen Datensätzen zu verknüpfen.
title

string

Erforderlich. Der Standortname sollte mit dem tatsächlichen Namen Ihres Unternehmens übereinstimmen, so wie er auch für Ihr Ladengeschäft, Ihre Website, Ihr Briefpapier und gegenüber Kunden gebräuchlich ist. Gegebenenfalls können zusätzliche Informationen in andere Felder der Ressource eingefügt werden (z. B. Address, Categories). Füge deinem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Es dürfen keine Marketingslogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten oder den Status „Geschlossen/geöffnet“, Telefonnummern, Website-URLs, Dienstleistungs-/Produktinformationen, Standort/Adresse oder Wegbeschreibungen oder Eingrenzungsinformationen (z. B. „Geldautomat in Duane Reade“) enthalten sein.
phoneNumbers

object (PhoneNumbers)

Optional. Die verschiedenen Telefonnummern, unter denen Kunden das Unternehmen kontaktieren können.
categories

object (Categories)

Optional. Die verschiedenen Kategorien, die das Unternehmen beschreiben.
storefrontAddress

object (PostalAddress)

Optional. Eine genaue Adresse zur Beschreibung Ihres Unternehmensstandorts. Postfächer an entfernten Standorten sind nicht zulässig. Derzeit können Sie maximal fünf addressLines-Werte in der Adresse angeben. Dieses Feld sollte nur für Unternehmen mit Ladengeschäft verwendet werden. Dieses Feld sollte nicht für Standorte vom Typ CUSTOMER_LOCATION_ONLY festgelegt werden. Wenn es jedoch festgelegt ist, werden alle angegebenen Werte verworfen.
websiteUri

string

Optional. Eine URL für dieses Unternehmen. Verwenden Sie nach Möglichkeit eine URL, die für diesen individuellen Unternehmensstandort steht, anstatt eine allgemeine Website/URL, die alle Standorte oder die Marke repräsentiert.
regularHours

object (BusinessHours)

Optional. Die Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Optional. Spezielle Öffnungszeiten für das Unternehmen. Dazu zählen in der Regel Öffnungszeiten an Feiertagen und andere Zeiten außerhalb der regulären Öffnungszeiten. Diese überschreiben die regulären Öffnungszeiten. Dieses Feld kann nicht ohne die regulären Öffnungszeiten festgelegt werden.
serviceArea

object (ServiceAreaBusiness)

Optional. Unternehmen ohne festen Standort in einem Einzugsgebiet bieten ihre Dienstleistungen am Standort des Kunden an. Wenn es sich bei diesem Unternehmen um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, beschreibt dieses Feld die Einzugsgebiete, in denen das Unternehmen tätig ist.
labels[]

string

Optional. Eine Sammlung frei definierbarer Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für Nutzer sichtbar, sondern nur für Sie sichtbar. Muss zwischen 1 und 255 Zeichen pro Label lang sein.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Optional. Zusätzliche Informationen, die in AdWords angezeigt werden
latlng

object (LatLng)

Optional. Vom Nutzer angegebener Breiten- und Längengrad. Beim Erstellen eines Standorts wird dieses Feld ignoriert, wenn die angegebene Adresse erfolgreich geocodiert wurde. Dieses Feld wird nur bei GET-Anfragen zurückgegeben, wenn der vom Nutzer angegebene latlng-Wert beim Erstellen akzeptiert oder der latlng-Wert über die Google Unternehmensprofil-Website aktualisiert wurde. Dieses Feld kann nur von genehmigten Kunden aktualisiert werden.
openInfo

object (OpenInfo)

Optional. Eine Markierung, die angibt, ob der Standort derzeit geöffnet ist.
metadata

object (Metadata)

Nur Ausgabe Zusätzliche Informationen, die nicht vom Nutzer bearbeitet werden können.
profile

object (Profile)

Optional. Sie beschreibt Ihr Unternehmen mit Ihren eigenen Worten und vermittelt Nutzern die einzigartige Geschichte Ihres Unternehmens und Ihres Angebots.

Dieses Feld ist für alle Kategorien mit Ausnahme von Unterkunftskategorien erforderlich (z.B. Hotels, Motels, Gasthäuser).
relationshipData

object (RelationshipData)

Optional. Alle zu diesem Standort gehörenden Standorte und Ketten.
moreHours[]

object (MoreHours)

Optional. Weitere Öffnungszeiten für verschiedene Abteilungen eines Unternehmens oder bestimmte Kunden
serviceItems[]

object (ServiceItem)

Optional. Liste der von Händlern unterstützten Dienstleistungen. Das kann zum Beispiel das Haareschneiden oder die Installation von Warmwasserbereitern sein. Doppelte Dienstleistungsgegenstände werden automatisch entfernt.

Methoden

delete

 Löscht einen Standort.

get

 Gibt den angegebenen Standort zurück

getAttributes

 Sucht nach allen Attributen, die für einen bestimmten Standort festgelegt wurden.

getGoogleUpdated

 Ruft die von Google aktualisierte Version des angegebenen Standorts ab.

patch

 Aktualisiert den angegebenen Standort.

updateAttributes

 Aktualisiere Attribute für einen bestimmten Standort.