REST Resource: locations

Recurso: Ubicación

Una ubicación Consulta el artículo del Centro de ayuda para obtener una descripción detallada de estos campos o el extremo de categoría para obtener una lista de las categorías de empresa válidas.

Representación JSON 
{
  "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)
    }
  ]
}
Campos
name

string

Es el identificador. Es el identificador de Google para esta ubicación con el siguiente formato: locations/{locationId}.
languageCode

string

Inmutable. Es el idioma de la ubicación. Se establece durante la creación y no se puede actualizar.
storeCode

string

Opcional. Es el identificador externo de esta ubicación, que debe ser único en una cuenta determinada. Esta es una forma de asociar la ubicación con tus propios registros.
title

string

Obligatorio. El nombre de la ubicación debe reflejar el nombre de tu empresa en el mundo real, es decir, debe coincidir con el nombre por el que la conocen los clientes y que se usa de forma coherente en tu vidriera, tu sitio web y tus documentos de negocio. Cualquier información adicional, cuando sea pertinente, se puede incluir en otros campos del recurso (por ejemplo, Address, Categories). No agregues información innecesaria a tu nombre (por ejemplo, prefiere "Google" en lugar de "Google Inc. - Mountain View Corporate Headquarters"). No incluyas eslóganes de marketing, códigos de tienda, caracteres especiales, horarios o estado de apertura o cierre, números de teléfono, URLs de sitios web, información de servicios o productos, ubicación, dirección o instrucciones sobre cómo llegar, ni información de contención (por ejemplo, "Cajero automático de Chase en Duane Reade").
phoneNumbers

object (PhoneNumbers)

Opcional. Son los diferentes números de teléfono que los clientes pueden usar para comunicarse con la empresa.
categories

object (Categories)

Opcional. Son las diferentes categorías que describen la empresa.
storefrontAddress

object (PostalAddress)

Opcional. Una dirección concreta y precisa para describir la ubicación de tu empresa No se permiten los apartados postales o buzones de correo en ubicaciones remotas. En este momento, puedes especificar un máximo de cinco valores addressLines en la dirección. Este campo solo se debe establecer para las empresas que tienen un establecimiento físico. Este campo no se debe establecer para las ubicaciones del tipo CUSTOMER_LOCATION_ONLY, pero, si se establece, se descartará cualquier valor proporcionado.
websiteUri

string

Opcional. Es una URL de esta empresa. Si es posible, usa una URL que represente esta ubicación individual de la empresa en lugar de un sitio web o una URL genéricos que representen todas las ubicaciones o la marca.
regularHours

object (BusinessHours)

Opcional. Es el horario de atención de la empresa.
specialHours

object (SpecialHours)

Opcional. Es el horario especial de la empresa. Por lo general, esto incluye el horario de atención en días feriados y otros horarios fuera del horario de atención habitual. Estos anulan el horario de atención habitual. Este campo no se puede establecer sin un horario habitual.
serviceArea

object (ServiceAreaBusiness)

Opcional. Las empresas de servicio en el área prestan sus servicios en la ubicación de los clientes. Si se trata de una empresa de servicio en el área, este campo describe las áreas en las que la empresa presta servicios.
labels[]

string

Opcional. Es una colección de cadenas de formato libre que te permiten etiquetar tu empresa. Estas etiquetas NO son visibles para los usuarios; solo tú puedes verlas. Debe tener entre 1 y 255 caracteres por etiqueta.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcional. Información adicional que se muestra en AdWords.
latlng

object (LatLng)

Opcional. Latitud y longitud proporcionadas por el usuario. Cuando se crea una ubicación, este campo se ignora si la dirección proporcionada se geocodifica correctamente. Este campo solo se devuelve en las solicitudes GET si se aceptó el valor de latlng proporcionado por el usuario durante la creación o si se actualizó el valor de latlng a través del sitio web del Perfil de Negocio de Google. Solo los clientes aprobados pueden actualizar este campo.
openInfo

object (OpenInfo)

Opcional. Es un indicador que señala si la ubicación está abierta actualmente para realizar actividades comerciales.
metadata

object (Metadata)

Solo salida. Información adicional que el usuario no puede editar.
profile

object (Profile)

Opcional. Describe tu empresa con tu propia voz y comparte con los usuarios la historia única de tu empresa y tus ofertas.

Este campo es obligatorio para todas las categorías, excepto las de alojamiento (p.ej., hoteles, moteles, posadas).
relationshipData

object (RelationshipData)

Opcional. Todas las ubicaciones y la cadena relacionadas con esta.
moreHours[]

object (MoreHours)

Opcional. Más horarios para los diferentes departamentos o clientes específicos de una empresa.
serviceItems[]

object (ServiceItem)

Opcional. Es la lista de servicios que admiten los comercios. Un servicio puede ser un corte de cabello, la instalación de un calentador de agua, etc. Los elementos de servicio duplicados se quitarán automáticamente.

Métodos

delete

 Borra una ubicación.

get

 Devuelve la ubicación especificada según la última configuración del comercio.

getAttributes

 Recupera los atributos de una ubicación según la última configuración del comercio.

getGoogleUpdated

 Devuelve la ubicación especificada tal como aparece publicada en Google Maps y la Búsqueda.

patch

 Actualiza la ubicación especificada.

updateAttributes

 Actualiza los atributos de una ubicación determinada.