REST Resource: locations

Ressource: Location

Einen Standort. Eine detaillierte Beschreibung dieser Felder finden Sie im Hilfeartikel. Eine Liste gültiger Unternehmenskategorien finden Sie unter Kategorieendpunkt.

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 bestimmten Kontos eindeutig sein muss. So verknüpfen Sie den Standort mit Ihren eigenen Einträgen.
title

string

Erforderlich. Der Standortname sollte den realen Namen Ihres Unternehmens widerspiegeln, wie er einheitlich auf Ihrem Schaufenster, Ihrer Website, Ihrem Briefpapier und auch bei Kunden verwendet wird. Gegebenenfalls können in anderen Feldern der Ressource weitere Informationen angegeben werden, z. B. Address oder Categories. Fügen Sie Ihrem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Verwenden Sie keine Marketingslogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten, Öffnungszeiten, Telefonnummern, Website-URLs, Service- oder Produktinformationen, Standort/Adresse, Wegbeschreibungen oder Begrenzungsinformationen (z. B. „Chase ATM in 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. Eine genaue und korrekte Adresse, um Ihren Unternehmensstandort zu beschreiben. Postfächer an entlegenen 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 festgelegt werden. Dieses Feld sollte nicht für Standorte vom Typ CUSTOMER_LOCATION_ONLY festgelegt werden. Wenn es aber konfiguriert ist, werden alle angegebenen Werte verworfen.
websiteUri

string

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

object (BusinessHours)

Optional. Die Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Optional. Spezielle Öffnungszeiten des Unternehmens Dazu gehören in der Regel Öffnungszeiten an Feiertagen und andere Zeiten außerhalb der normalen Ö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 stellen ihre Dienstleistungen am Standort des Kunden bereit. Wenn es sich bei diesem Unternehmen um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, beschreibt dieses Feld das Einzugsgebiet, in dem es bedient wird.
labels[]

string

Optional. Eine Sammlung von Strings im freien Format, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für den Nutzer sichtbar. und nur du kannst sie sehen. Muss zwischen 1 und 255 Zeichen pro Label enthalten.
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 bereitgestellte 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. Ihr Unternehmen mit Ihren eigenen Worten beschreiben und Nutzern mitteilen, wodurch sich Ihr Unternehmen und sein Angebot von anderen abhebt.

Dieses Feld muss für alle Kategorien außer Unterkunftskategorien ausgefüllt werden (z.B. Hotels, Motels, Gasthäuser).
relationshipData

object (RelationshipData)

Optional. Alle zugehörigen Standorte und Ketten.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Optional. Liste der von Händlern unterstützten Dienstleistungen. Das kann z. B. der Friseur 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 alle für einen bestimmten Standort festgelegten Attribute.

getGoogleUpdated

 Ruft die von Google aktualisierte Version des angegebenen Standorts ab.

patch

 Aktualisiert den angegebenen Standort.

updateAttributes

 Attribute für einen bestimmten Standort aktualisieren