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. 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 que se usa en tu vidriera, sitio web y papelería, y como lo conocen los clientes. Cuando corresponda, se puede incluir información adicional en otros campos del recurso (por ejemplo, Address o Categories). No agregues información innecesaria a tu nombre (por ejemplo, prioriza "Google" en lugar de "Google Inc., sede corporativa de Mountain View"). No incluyas descripciones de marketing, códigos de tienda, caracteres especiales, horarios o estado de cierre o abierto, números de teléfono, URLs de sitios web, información de productos o servicios, ubicación, dirección, instrucciones sobre cómo llegar ni información sobre la contención (por ejemplo, “Cajero automático de la empresa 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. Las diferentes categorías que describen 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 se debe configurar para las empresas que tienen un establecimiento físico. Este campo no debe establecerse para las 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érico que represente todas las ubicaciones o la marca.
regularHours

object (BusinessHours)

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

object (SpecialHours)

Opcional. Horario especial de la empresa Esto suele incluir los horarios de los feriados y otros horarios fuera del horario de atención habitual. Estos 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 brindan sus servicios en la ubicación del cliente. Si esta es una empresa de servicio en área, en este campo se describen las áreas en las que presta servicios la empresa.
labels[]

string

Opcional. Una colección de cadenas de formato libre que te permiten etiquetar tu negocio. Estas etiquetas NO están para el usuario; solo tú puedes verlos. 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 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 el valor latlng se actualizó 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 en este momento.
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. Lista de servicios que ofrecen los comercios. Un servicio puede cortarse de cabello, instalar un calentador de agua, etc. Los artículos 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 establecidos para una ubicación determinada.

getGoogleUpdated

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

patch

 Actualiza la ubicación especificada.

updateAttributes

 Actualiza los atributos de una ubicación determinada.