REST Resource: locations

Ressource: Location

Einen Ort. Eine detaillierte Beschreibung dieser Felder finden Sie in diesem Hilfeartikel. Eine Liste der gültigen Unternehmenskategorien finden Sie unter category.

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

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

string

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

string

Optional. Externe Kennung für diesen Standort, die innerhalb eines bestimmten Kontos eindeutig sein muss. So können Sie den Standort mit Ihren eigenen Datensätzen verknüpfen.
title

string

Erforderlich. Der Name des Standorts sollte dem tatsächlichen Namen Ihres Unternehmens entsprechen, der einheitlich am Ladengeschäft, auf der Website und auf Briefpapier verwendet wird und den Kunden kennen. Alle zusätzlichen Informationen können, sofern relevant, in anderen Feldern der Ressource angegeben werden (z. B. Address, Categories). Fügen Sie dem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Geben Sie keine Marketing-Slogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten oder Informationen dazu, ob das Geschäft geöffnet oder geschlossen ist, Telefonnummern, Website-URLs, Produktinformationen, Standort/Adresse oder Wegbeschreibungen oder Informationen zu anderen Geschäften im selben Gebäude an (z. B. „Chase-Geldautomat bei Duane Reade“).
phoneNumbers

object (PhoneNumbers)

Optional. Die verschiedenen Telefonnummern, über die Kunden das Unternehmen kontaktieren können.
categories

object (Categories)

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

object (PostalAddress)

Optional. Die korrekte Anschrift Ihres Unternehmens. Postfächer oder Briefkästen an unternehmensfremden 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 einem Ladengeschäft festgelegt werden. Dieses Feld sollte für Orte vom Typ CUSTOMER_LOCATION_ONLY nicht festgelegt werden. Wenn es festgelegt wird, wird der angegebene Wert verworfen.
websiteUri

string

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

object (BusinessHours)

Optional. Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Optional. Spezielle Öffnungszeiten des Unternehmens. Dazu gehören in der Regel Feiertage und andere Zeiten außerhalb der regulären Öffnungszeiten. Diese überschreiben die regulären Öffnungszeiten. Dieses Feld kann nicht ohne reguläre Öffnungszeiten festgelegt werden.
serviceArea

object (ServiceAreaBusiness)

Optional. Unternehmen ohne festen Standort in einem Einzugsgebiet erbringen ihre Dienstleistungen am Standort des Kunden. Wenn es sich um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, wird in diesem Feld das Einzugsgebiet des Unternehmens beschrieben.
labels[]

string

Optional. Eine Sammlung frei definierbarer Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind für Nutzer NICHT sichtbar. Nur Sie können sie sehen. Muss 1–255 Zeichen pro Label umfassen.
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 wird. 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 Clients aktualisiert werden.
openInfo

object (OpenInfo)

Optional. Ein Flag, das 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. Ihr Unternehmen mit Ihren eigenen Worten beschreiben und Nutzern mitteilen, wodurch sich Ihr Unternehmen und sein Angebot von anderen abheben.

Dieses Feld ist für alle Kategorien außer Unterkunftskategorien (z.B. Hotels, Motels, Gasthäuser) erforderlich.
relationshipData

object (RelationshipData)

Optional. Alle Standorte und Ketten, die mit diesem Standort verknüpft sind.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Optional. Liste der von Händlern unterstützten Dienste. Ein Dienst kann z. B. „Haarschnitt“ oder „Warmwasserbereiter installieren“ sein. Doppelte Dienstleistungen werden automatisch entfernt.

Methoden

delete

 Löscht einen Standort.

get

 Gibt den angegebenen Standort zurück, wie er zuletzt vom Händler festgelegt wurde.

getAttributes

 Ruft Attribute für einen Standort ab, die zuletzt vom Händler festgelegt wurden.

getGoogleUpdated

 Gibt den angegebenen Standort so zurück, wie er auf Google Maps und in der Google Suche angezeigt wird.

patch

 Aktualisiert den angegebenen Standort.

updateAttributes

 Aktualisiert Attribute für einen bestimmten Standort.