REST Resource: accounts.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.

PhoneNumbers

Es una colección de números de teléfono de la empresa. Durante las actualizaciones, se deben configurar ambos campos. Los clientes no pueden actualizar solo los números de teléfono principales o adicionales con la máscara de actualización. Se prefiere el formato de teléfono internacional, como "+1 415 555 0132". Consulta más información en (https://developers.google.com/style/phone-numbers#international-phone-numbers).

Representación JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Campos
primaryPhone

string

Obligatorio. Un número de teléfono que permita a los usuarios comunicarse con la ubicación específica de tu empresa de la manera más directa posible Utiliza un número de teléfono local en vez de un número central de asistencia telefónica, siempre que sea posible.
additionalPhones[]

string

Opcional. Hasta dos números de teléfono (celular o fijo, no fax) a los que se puede llamar a tu empresa, además de tu número de teléfono principal

Categorías

Es una colección de categorías que describen la empresa. Durante las actualizaciones, se deben configurar ambos campos. Los clientes no pueden actualizar de forma individual las categorías principales o adicionales con la máscara de actualización.

Representación JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Campos
primaryCategory

object (Category)

Obligatorio. Es la categoría que mejor describe la actividad principal de esta ubicación.
additionalCategories[]

object (Category)

Opcional. Categorías adicionales para describir tu empresa Las categorías ayudan a los clientes a encontrar resultados precisos y específicos para los servicios que les interesan. Para mantener la información de tu empresa precisa y actualizada, asegúrate de usar la menor cantidad posible de categorías para describir tu actividad comercial principal de la manera más general. Selecciona categorías que sean lo más específicas posible, pero que representen tu actividad comercial principal.

Categoría

Una categoría que describa lo que es esta empresa (no lo que hace) Para obtener una lista de los IDs de categoría válidos y las asignaciones a sus nombres legibles por humanos, consulta categories.list.

Representación JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Campos
name

string

Obligatorio. Es un ID estable (proporcionado por Google) para esta categoría. Se debe especificar el valor cuando se modifica la categoría (cuando se crea o actualiza una ubicación).
displayName

string

Solo salida. Es el nombre legible por humanos de la categoría. Se establece cuando se lee la ubicación. Cuando se modifica la ubicación, se debe establecer category_id.
serviceTypes[]

object (ServiceType)

Solo salida. Es una lista de todos los tipos de servicio disponibles para esta categoría de empresa.
moreHoursTypes[]

object (MoreHoursType)

Solo salida. Son los tipos de horarios adicionales que están disponibles para esta categoría de empresa.

ServiceType

Es un mensaje que describe un tipo de servicio que ofrece la empresa.

Representación JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
Campos
serviceTypeId

string

Solo salida. Es un ID estable (proporcionado por Google) para este tipo de servicio.
displayName

string

Solo salida. Es el nombre visible legible por humanos del tipo de servicio.

MoreHoursType

Son los tipos de horarios adicionales que puede ofrecer una empresa, además de su horario habitual.

Representación JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Campos
hoursTypeId

string

Solo salida. Es un ID estable que proporciona Google para este tipo de horario.
displayName

string

Solo salida. Es el nombre visible en inglés legible por humanos para el tipo de horario.
localizedDisplayName

string

Solo salida. Es el nombre visible localizado y legible por humanos para el tipo de horario.

PostalAddress

Representa una dirección postal, como para la entrega postal o las direcciones de pago. Con una dirección postal, un servicio de correo puede entregar artículos en un local, un apartado postal o un lugar similar. Una dirección postal no está diseñada para modelar ubicaciones geográficas, como rutas, ciudades o montañas.

En el uso típico, una dirección se crearía a partir de la entrada del usuario o de la importación de datos existentes, según el tipo de proceso.

Consejos para ingresar o editar direcciones:

  • Usa un widget de dirección listo para la internacionalización, como https://github.com/google/libaddressinput.
  • No se deben presentar a los usuarios elementos de la IU para ingresar o editar campos fuera de los países en los que se usa ese campo.

Para obtener más orientación sobre cómo usar este esquema, consulta https://support.google.com/business/answer/6397478.

Representación JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campos
revision

integer

Es la revisión del esquema de PostalAddress. Se debe configurar como 0, que es la última versión.

Todas las revisiones nuevas deben ser retrocompatibles con las revisiones anteriores.
regionCode

string

Obligatorio Código de región de CLDR para el país o la región de la dirección. Nunca se infiere y depende del usuario garantizar que el valor sea correcto. Consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html para obtener más detalles. Ejemplo: "CH" para Suiza.
languageCode

string

Opcional: Código de idioma BCP-47 de los contenidos de esta dirección (si se conoce). Suele ser el idioma de la IU del formulario de entrada o se espera que coincida con uno de los idiomas usados en la región o el país de la dirección, o sus transliteraciones equivalentes. Esto puede afectar el formato en ciertos países, pero no es fundamental para la precisión de los datos y nunca afectará una validación o alguna otra operación no relacionada con el formato.

Si este valor es desconocido, se debe omitir (en lugar de especificar una configuración predeterminada posiblemente incorrecta).

Ejemplos: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Opcional: Código postal de la dirección. No todos los países usan códigos postales o requieren que se incluyan, pero, cuando se usan, pueden activar una validación adicional con otras partes de la dirección (por ejemplo, la validación del estado o del código postal en Estados Unidos).
sortingCode

string

Opcional. Código de ordenamiento adicional específico para cada país. No se usa en la mayoría de las regiones. Cuando se usa, el valor es una cadena como "CEDEX", seguida opcionalmente de un número (por ejemplo, "CEDEX 7"), o solo un número, que representa el "código de sector" (Jamaica), el "indicador de área de entrega" (Malawi) o el "indicador de oficina de correos" (Costa de Marfil).
administrativeArea

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En el caso de España, se trata de la provincia y no de la comunidad autónoma (por ejemplo, "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. Por ejemplo, en Suiza, este campo debe dejarse vacío.
locality

string

Opcional. Por lo general, se refiere a la parte de la dirección que indica la ciudad o el pueblo. Ejemplos: ciudad de EE.UU., comuna de Italia o ciudad postal en el Reino Unido. En regiones del mundo en que las localidades no están bien definidas o no se ajustan bien a esta estructura, deja vacío el campo locality y usa addressLines.
sublocality

string

Opcional. Sublocalidad de la dirección. Por ejemplo, puede ser un vecindario, un municipio o un distrito.
addressLines[]

string

Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección.

Debido a que los valores de addressLines no tienen información de tipo y, a veces, pueden contener varios valores en un solo campo (por ejemplo, "Austin, TX"), es importante que el orden de las líneas sea claro. El orden de las líneas de dirección debe ser el "orden del sobre" para el país o la región de la dirección. En los lugares donde esto puede variar (por ejemplo, Japón), se usa address_language para que sea explícito (por ejemplo, "ja" para el orden de mayor a menor y "ja-Latn" o "en" para el orden de menor a mayor). De esta manera, se puede seleccionar la línea más específica de una dirección según el idioma.

La representación estructural mínima permitida de una dirección consiste en un regionCode con toda la información restante colocada en el addressLines. Sería posible dar un formato a una dirección así de manera muy aproximada sin codificación geográfica, pero no podría realizarse un análisis semántico de ningún componente de la dirección hasta que se resuelva, al menos, de manera parcial.

La forma recomendada de controlar las direcciones completamente no estructuradas es crear una dirección que solo contenga un regionCode y un addressLines, y luego geocodificarla (en lugar de adivinar qué partes de la dirección deben ser localidades o áreas administrativas).
recipients[]

string

Opcional. El destinatario en la dirección. Es posible que este campo contenga varias líneas de información en ciertas circunstancias. Por ejemplo, puede contener información sobre la entrega "por medio de".
organization

string

Opcional: El nombre de la organización de la dirección.

BusinessHours

Representa los períodos en los que esta ubicación está abierta al público. Contiene una colección de instancias de [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Representación JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Campos
periods[]

object (TimePeriod)

Obligatorio. Es una colección de horarios en los que esta ubicación está abierta al público. Cada período representa un rango de horas en el que la ubicación está abierta durante la semana.

TimePeriod

Representa un período durante el cual la empresa está abierta, que comienza en el día y la hora de apertura especificados, y finaliza en el día y la hora de cierre especificados. La hora de cierre debe ser posterior a la de apertura, por ejemplo, más tarde el mismo día o en un día posterior.

Representación JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Campos
openDay

enum (DayOfWeek)

Obligatorio. Indica la day of the week en la que comienza este período.
openTime

object (TimeOfDay)

Obligatorio. Los valores válidos son de 00:00 a 24:00, donde 24:00 representa la medianoche al final del campo de día especificado. Nota: En la asignación de JSON de Proto3, se omiten los valores predeterminados de cero (00:00), lo que produce {} para openTime.
closeDay

enum (DayOfWeek)

Obligatorio. Indica la fecha (day of the week) en que finaliza este período.
closeTime

object (TimeOfDay)

Obligatorio. Los valores válidos son de 00:00 a 24:00, donde 24:00 representa la medianoche al final del campo de día especificado. Nota: En la asignación de JSON de Proto3, se omiten los valores predeterminados de cero (00:00), lo que produce {} para closeTime.

DayOfWeek

Representa un día de la semana.

Enumeraciones
DAY_OF_WEEK_UNSPECIFIED No se especifica el día de la semana.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY Miércoles
THURSDAY Jueves
FRIDAY Viernes
SATURDAY Sábado
SUNDAY Domingo

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos intercalares. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas de un día en formato de 24 horas. Debe ser mayor o igual que 0 y, por lo general, menor o igual que 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de una hora. Debe ser mayor o igual que 0 y menor o igual que 59.
seconds

integer

Segundos de un minuto. Debe ser mayor o igual que 0 y, por lo general, menor o igual que 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos, en nanosegundos. Debe ser mayor o igual que 0 y menor o igual que 999,999,999.

SpecialHours

Representa un conjunto de períodos en los que el horario de atención de una ubicación difiere de su horario de atención habitual.

Representación JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Campos
specialHourPeriods[]

object (SpecialHourPeriod)

Obligatorio. Es una lista de excepciones al horario de atención habitual de la empresa.

SpecialHourPeriod

Representa un solo período en el que el horario de atención de una ubicación difiere de su horario de atención normal. Un período de horario especial debe representar un intervalo de menos de 24 horas. openTime y startDate deben ser anteriores a closeTime y endDate. La closeTime y la endDate pueden extenderse hasta las 11:59 a.m. del día posterior a la startDate especificada. Por ejemplo, las siguientes entradas son válidas:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Las siguientes entradas no son válidas:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Representación JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Campos
startDate

object (Date)

Obligatorio. Es la fecha del calendario en la que comienza este período de horario especial.
openTime

object (TimeOfDay)

Opcional. Los valores válidos son de 00:00 a 24:00, donde 24:00 representa la medianoche al final del campo de día especificado. Se debe especificar si closed es falso.
endDate

object (Date)

Opcional. Es la fecha del calendario en la que finaliza este período de horario especial. Si no se establece el campo endDate, se usa de forma predeterminada la fecha especificada en startDate. Si se establece, este campo debe ser igual o, como máximo, 1 día posterior a startDate.
closeTime

object (TimeOfDay)

Opcional. Los valores válidos son de 00:00 a 24:00, donde 24:00 representa la medianoche al final del campo de día especificado. Se debe especificar si closed es falso.
closed

boolean

Opcional. Si es verdadero, se ignoran endDate, openTime y closeTime, y la fecha especificada en startDate se trata como la ubicación que se cierra durante todo el día.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

ServiceAreaBusiness

Las empresas de servicio en el área proporcionan sus servicios en la ubicación del cliente (por ejemplo, un cerrajero o un plomero).

Representación JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Campos
businessType

enum (BusinessType)

Obligatorio. Indica el [tipo] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] de la empresa de servicio en el área.
places

object (Places)

Opcional. Es el área en la que esta empresa ofrece servicios, definida a través de un conjunto de lugares.
regionCode

string

Inmutable. Es el código de región de CLDR del país o la región en que se encuentra esta empresa de servicio en el área. Consulta http://cldr.unicode.org/ y http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html para obtener más detalles. Ejemplo: "CH" para Suiza.

Este campo es obligatorio para las empresas de tipo CUSTOMER_LOCATION_ONLY y se ignora en los demás casos.

La región que se especifica aquí puede ser diferente de las regiones de las áreas en las que esta empresa presta servicios (p.ej., empresas de servicio en el área que prestan servicios en regiones distintas de aquella en la que se encuentran).

Si esta ubicación requiere verificación después de su creación, la dirección proporcionada para fines de verificación debe encontrarse dentro de esta región, y el propietario de la empresa o su representante autorizado deben poder recibir correo postal en la dirección de verificación proporcionada.

BusinessType

Indica si esta empresa solo ofrece servicios en la ubicación del cliente (por ejemplo, un camión de remolque) o tanto en una dirección como en la ubicación del cliente (por ejemplo, una pizzería con un área de comedor que también realiza entregas a domicilio).

Enums
BUSINESS_TYPE_UNSPECIFIED Solo salida. No se especifica.
CUSTOMER_LOCATION_ONLY Ofrece servicios solo en el área circundante (no en la dirección comercial). Si una empresa se actualiza de CUSTOMER_AND_BUSINESS_LOCATION a CUSTOMER_LOCATION_ONLY, la actualización de la ubicación debe incluir la máscara de campo storefrontAddress y establecer el campo como vacío.
CUSTOMER_AND_BUSINESS_LOCATION Ofrece servicios en la dirección comercial y el área circundante.

Lugares

Define la unión de áreas representadas por un conjunto de lugares.

Representación JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Campos
placeInfos[]

object (PlaceInfo)

Opcional. Son las áreas representadas por los IDs de lugar. Se limita a un máximo de 20 lugares.

PlaceInfo

Define un área representada por un ID de lugar.

Representación JSON 
{
  "placeName": string,
  "placeId": string
}
Campos
placeName

string

Obligatorio. Es el nombre localizado del lugar. Por ejemplo, Scottsdale, AZ.
placeId

string

Obligatorio. Es el ID del lugar. Debe corresponder a una región. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

Información adicional que se muestra en AdWords.

Representación JSON 
{
  "adPhone": string
}
Campos
adPhone

string

Obligatorio. Es un número de teléfono alternativo que se muestra en las extensiones de ubicación de AdWords en lugar del número de teléfono principal de la ubicación.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de dobles para representar la latitud en grados y la longitud en grados. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

OpenInfo

Información relacionada con el estado de apertura de la empresa.

Representación JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Campos
status

enum (OpenForBusiness)

Obligatorio. Indica si la ubicación está abierta actualmente para el negocio. Todas las ubicaciones están abiertas de forma predeterminada, a menos que se actualicen para que aparezcan como cerradas.
canReopen

boolean

Solo salida. Indica si esta empresa es apta para volver a abrirse.
openingDate

object (Date)

Opcional. Es la fecha en que se abrió la ubicación por primera vez. Si no se conoce el día exacto, solo se pueden proporcionar el mes y el año. La fecha debe ser anterior a la actual o no puede ser posterior a un año en el futuro.

OpenForBusiness

Indica el estado de una ubicación.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED No se especifica.
OPEN Indica que la ubicación está abierta.
CLOSED_PERMANENTLY Indica que la ubicación se cerró permanentemente.
CLOSED_TEMPORARILY Indica que la ubicación se cerró temporalmente.

Metadatos

Información adicional sobre la ubicación que el usuario no puede editar.

Representación JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
Campos
hasGoogleUpdated

boolean

Solo salida. Indica si el ID de lugar asociado con esta ubicación tiene actualizaciones que el cliente debe actualizar o rechazar. Si se establece este valor booleano, debes llamar al método getGoogleUpdated para buscar la información que se debe verificar.
hasPendingEdits

boolean

Solo salida. Indica si alguna de las propiedades de esta ubicación se encuentra en estado de edición pendiente.
canDelete

boolean

Solo salida. Indica si la ubicación se puede borrar con la API.
canOperateLocalPost
(deprecated)

boolean

Solo salida. Obsoleto: Este campo ya no se propaga y se quitará en una versión futura.
canModifyServiceList

boolean

Solo salida. Indica si la ficha puede modificar la lista de servicios.
canHaveFoodMenus

boolean

Solo salida. Indica si la ficha es apta para el menú de comida.
canOperateHealthData

boolean

Solo salida. Indica si la ubicación puede operar con datos de salud.
canOperateLodgingData

boolean

Solo salida. Indica si la ubicación puede operar con datos de alojamiento.
placeId

string

Solo salida. Si esta ubicación aparece en Google Maps, este campo se completa con el ID de lugar de la ubicación. Este ID se puede usar en varias APIs de Places.

Este campo se puede establecer durante las llamadas de creación, pero no para la actualización.
duplicateLocation

string

Solo salida. Es el recurso de ubicación que duplica esta ubicación.
mapsUri

string

Solo salida. Un vínculo a la ubicación en Maps
newReviewUri

string

Solo salida. Es un vínculo a la página de la Búsqueda de Google en la que un cliente puede dejar una opinión sobre la ubicación.
canHaveBusinessCalls

boolean

Solo salida. Indica si la ficha es apta para recibir llamadas de la empresa.
hasVoiceOfMerchant

boolean

Solo salida. Indica si la ficha tiene la Voz del comercio. Si este valor booleano es falso, debes llamar a la API de locations.getVoiceOfMerchantState para obtener detalles sobre por qué no tienen Voice of Merchant.
isParticularlyPersonalPlace

boolean

Solo salida. Indica si la ubicación se clasifica como un lugar particularmente privado. Esto significa que hay restricciones en las funciones del Historial de ubicaciones. Si crees que se trata de un error, consulta el artículo del Centro de ayuda.

Perfil

Toda la información relacionada con el perfil de la ubicación.

Representación JSON 
{
  "description": string
}
Campos
description

string

Obligatorio. Descripción de la ubicación con tu propia voz, que nadie más puede editar

RelationshipData

Información de todas las ubicaciones superiores y secundarias relacionadas con esta.

Representación JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Campos
parentLocation

object (RelevantLocation)

Opcional. Es la ubicación superior con la que se relaciona esta ubicación.
childrenLocations[]

object (RelevantLocation)

Opcional. Es la lista de ubicaciones secundarias con las que se relaciona esta ubicación.
parentChain

string

Opcional. Es el nombre del recurso de la cadena a la que pertenece esta ubicación. [Cómo encontrar el ID de la cadena] [Locations.SearchChains]

RelevantLocation

Información sobre otra ubicación relacionada con la actual. La relación puede ser DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF, y la ubicación especificada aquí puede estar en cualquier lado (superior o secundario) de la ubicación.

Representación JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Campos
placeId

string

Obligatorio. Especifica la ubicación que se encuentra en el otro lado de la relación por su placeID.
relationType

enum (RelationType)

Obligatorio. Es el tipo de relación.

RelationType

Las relaciones de tipo que se especificarán.

Enums
RELATION_TYPE_UNSPECIFIED Indica un tipo no especificado.
DEPARTMENT_OF Esto representa una relación entre 2 ubicaciones que comparten un área física, la misma marca, la misma administración superior o la misma organización, pero con diferentes atributos clave, como el horario de atención o los números de teléfono. Por ejemplo, Costco Pharmacy es un departamento de Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Esto representa los casos en los que 2 ubicaciones se encuentran en el mismo lugar físico, pero pertenecen a diferentes empresas (p.ej., Starbucks en un Safeway, tiendas en un centro comercial).

MoreHours

Son los períodos durante los cuales una ubicación está abierta para ciertos tipos de empresas.

Representación JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Campos
hoursTypeId

string

Obligatorio. Es el tipo de horario. Los clientes deben llamar a {#link businessCategories:BatchGet} para obtener los tipos de horarios admitidos para las categorías de sus ubicaciones.
periods[]

object (TimePeriod)

Obligatorio. Es una colección de horarios en los que esta ubicación está abierta. Cada período representa un rango de horas en el que la ubicación está abierta durante la semana.

ServiceItem

Es un mensaje que describe un solo elemento de servicio. Se usa para describir el tipo de servicio que proporciona el comercio. Por ejemplo, un corte de cabello puede ser un servicio.

Representación JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Campos
price

object (Money)

Opcional. Representa el precio monetario del elemento de servicio. Te recomendamos que configures currencyCode y units cuando incluyas un precio. Este se tratará como un precio fijo para el elemento de servicio.
Siempre se debe establecer uno de los siguientes campos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
structuredServiceItem

object (StructuredServiceItem)

Opcional. Este campo se establecerá en el caso de los datos de servicios estructurados.
freeFormServiceItem

object (FreeFormServiceItem)

Opcional. Este campo se establecerá en el caso de los datos de servicios de formato libre.
Fin de los campos mutuamente excluyentes.

StructuredServiceItem

Representa un servicio estructurado que ofrece el comercio. Por ejemplo: toilet_installation.

Representación JSON 
{
  "serviceTypeId": string,
  "description": string
}
Campos
serviceTypeId

string

Obligatorio. El campo serviceTypeId es un ID único proporcionado por Google que se puede encontrar en ServiceType. Esta información la proporciona el servicio de RPC categories.batchGet.
description

string

Opcional. Descripción del elemento de servicio estructurado. El límite de caracteres es de 300.

FreeFormServiceItem

Representa un servicio de formato libre que ofrece el comercio. Estos son servicios que no se exponen como parte de nuestros datos de servicio de estructura. El comercio ingresa manualmente los nombres de esos servicios con una plataforma de Geomerchant.

Representación JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Campos
category

string

Obligatorio. Este campo representa el nombre de la categoría (es decir, el ID estable de la categoría). Los valores de category y serviceTypeId deben coincidir con las combinaciones posibles proporcionadas en el mensaje Category.
label

object (Label)

Obligatorio. Son las etiquetas de idioma del artículo. Te recomendamos que los nombres de los elementos tengan 140 caracteres o menos, y las descripciones, 250 caracteres o menos. Este campo solo se debe establecer si la entrada es un elemento de servicio personalizado. Los tipos de servicio estandarizados deben actualizarse con serviceTypeId.

Etiqueta

Es la etiqueta que se usará cuando se muestre la lista de precios, la sección o el artículo.

Representación JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Campos
displayName

string

Obligatorio. Es el nombre visible de la lista de precios, la sección o el elemento.
description

string

Opcional. Es la descripción de la lista de precios, la sección o el artículo.
languageCode

string

Opcional. Es el código de idioma BCP-47 al que se aplican estas cadenas. Solo se puede establecer un conjunto de etiquetas por idioma.

Dinero

Representa un importe de dinero con su tipo de moneda.

Representación JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

Es el código de moneda de tres letras definido en la norma ISO 4217.
units

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", 1 unidad es un dólar estadounidense.
nanos

integer

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si units es positivo, nanos debe ser positivo o cero. Si units es cero, nanos puede ser positivo, cero o negativo. Si units es negativo, nanos debe ser negativo o cero. Por ejemplo, -$1.75 se representa como units=-1 y nanos=-750,000,000.

Métodos

create

 Crea una ubicación nueva que pertenecerá al usuario conectado.

list

 Muestra una lista de las ubicaciones de la cuenta especificada.