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 la 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 de Google para esta ubicación con el formato: locations/{locationId}.
languageCode

string

Inmutable. 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. Esto es una manera 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 de tu empresa, tal como lo conocen los clientes y en tu vidriera, sitio web y en tus papeles corporativos. Cuando sea relevante, puedes incluir cualquier información adicional en otros campos del recurso (por ejemplo, Address, Categories). No agregues información innecesaria a tu nombre (por ejemplo, elige "Google" en lugar de "Google Inc. - Sede central corporativa de Mountain View"). No incluyas eslóganes de marketing, códigos de tienda, caracteres especiales, horarios o estado cerrado o abierto, números de teléfono, URLs de sitios web, información del producto o servicio, ubicación/dirección o instrucciones sobre cómo llegar, ni información de contención (por ejemplo, "Cajero automático del banco en Bariloche").
phoneNumbers

object (PhoneNumbers)

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

object (Categories)

Opcional. Las diferentes categorías que describen a la empresa.
storefrontAddress

object (PostalAddress)

Opcional. Una dirección precisa y exacta para describir la ubicación de tu empresa No se aceptan 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 debe configurarse para las empresas que tienen un establecimiento físico. Este campo no debe configurarse para ubicaciones de tipo CUSTOMER_LOCATION_ONLY, pero si se configura, se descartará cualquier valor proporcionado.
websiteUri

string

Opcional. Una URL para esta empresa. Si es posible, utiliza una URL que represente la ubicación individual de esta empresa, en lugar de una URL o un sitio web 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. Horario especial de la empresa Esto suele incluir el horario de los días feriados y otros horarios fuera del horario de atención habitual. Anulan el horario de atención habitual. Este campo no se puede configurar sin un horario habitual.
serviceArea

object (ServiceAreaBusiness)

Opcional. Las empresas de servicio en el área ofrecen sus servicios en la ubicación del cliente. Si esta empresa es una empresa de servicio en el área, este campo describe las áreas en las que presta servicios.
labels[]

string

Opcional. Una colección de cadenas de formato libre que te permiten etiquetar tu empresa. Estas etiquetas NO se muestran al usuario; solo tú puedes verlas. Debe tener entre 1 y 255 caracteres por etiqueta.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcional. Es la información adicional que se muestra en AdWords.
latlng

object (LatLng)

Opcional. Latitud y longitud proporcionadas por el usuario. Al crear una ubicación, este campo se ignora si la dirección proporcionada se geocodifica correctamente. Este campo solo se muestra en las solicitudes get si se aceptó el valor latlng proporcionado por el usuario durante la creación o si se actualizó el valor 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. Una marca que indica si la ubicación está abierta actualmente.
metadata

object (Metadata)

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

object (Profile)

Opcional. Describe tu empresa con tus propias palabras y comparte con los usuarios la historia única de tu empresa y sus ofertas.

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

object (RelationshipData)

Opcional. Todas las ubicaciones y cadenas 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. Lista de los servicios que admiten los comercios. Los servicios pueden ser cortes de cabello, instalar calentadores de agua, etc. Los elementos de servicio duplicados se quitarán automáticamente.

Métodos

delete

 Borra una ubicación.

get

 Muestra la ubicación especificada.

getAttributes

 Busca todos los atributos configurados para una ubicación determinada.

getGoogleUpdated

 Obtiene la versión actualizada por Google de la ubicación especificada.

patch

 Actualiza la ubicación especificada.

updateAttributes

 Actualiza los atributos de una ubicación determinada.