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 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.

PhoneNumbers

Un conjunto de números de teléfono para la empresa Durante las actualizaciones, se deben configurar ambos campos. Es posible que los clientes no actualicen 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". Obtén 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 conecta con la ubicación individual 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 (celulares o fijos, no fax), además de tu número de teléfono principal, a los que los usuarios puedan llamar para comunicarse con tu empresa.

Categorías

Es una colección de categorías que describe la empresa. Durante las actualizaciones, se deben configurar ambos campos. Los clientes tienen prohibido actualizar individualmente 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 empresa principal en la que participa 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 que la información de tu empresa sea precisa y esté publicada, asegúrate de utilizar la menor cantidad posible de categorías para describir la actividad comercial principal en general. Elige categorías que sean lo más específicas posible, pero que, a su vez, sean representativas de tu actividad comercial principal

Categoría

Es una categoría que describe qué es esta empresa (no a qué se dedica). 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. Un ID estable (proporcionado por Google) para esta categoría. El valor se debe especificar cuando se modifica la categoría (al crear o actualizar una ubicación).
displayName

string

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

object (ServiceType)

Solo salida. Una lista de todos los tipos de servicios disponibles para esta categoría de empresa.
moreHoursTypes[]

object (MoreHoursType)

Solo salida. Más tipos de horarios 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. Un ID estable (proporcionado por Google) para este tipo de servicio.
displayName

string

Solo salida. Es el nombre visible del tipo de servicio en lenguaje natural.

MoreHoursType

Más tipos de horarios 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 hora.
localizedDisplayName

string

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

PostalAddress

Representa una dirección postal, p. ej., para envíos postales o direcciones de pago. Si se proporciona una dirección postal, un servicio postal puede enviar artículos a las instalaciones, a la casilla postal o a otras ubicaciones similares. No está diseñado para modelar ubicaciones geográficas (caminos, pueblos, montañas).

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

Consejos sobre el ingreso o la edición de direcciones: - Usa un widget de dirección preparado para la internacionalización, como https://github.com/google/libaddressinput). - Los usuarios no deben ver elementos de la IU para ingresar o editar campos fuera de países en los que se usa ese campo.

Para obtener 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

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

Todas las revisiones nuevas deben ser compatibles 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 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 o exigen la presencia de códigos postales, pero en los lugares donde se usan, es posible que activen una validación adicional con otras partes de la dirección (p. ej., validación del código postal o el estado en EE.UU.).
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 utiliza, el valor es una cadena como "CEDEX", opcionalmente seguida de un número (p.ej., "CEDEX 7"), o solo un número, que representa el "código de sector" (Jamaica), "indicador del área de entrega" (Malaui) o "indicador de oficina de correos" (p.ej., 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. Específicamente, en el caso de España, corresponde a la provincia y no a la comunidad autónoma (p.ej., "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. P. ej., en Suiza se dejaría 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 donde las localidades no están bien definidas o no coinciden bien con esta estructura, deja la localidad vacía y usa addressLines.
sublocality

string

Opcional: Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos.
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, en ocasiones, pueden contener varios valores en un solo campo (p.ej., "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 de sobre" que se usa en el país o la región de la dirección. En lugares donde esto puede variar, (p. ej., Japón), address_language se usa para hacerlo explícito (p. ej., "ja" para ordenar de mayor a menor en "ja-Latn" o "en" para indicar de menor a mayor). De esta manera, se puede seleccionar la línea más específica de una dirección a partir del idioma.

La representación estructural mínima que se permite para una dirección consiste en un regionCode con toda la información restante incluida en 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.

Crear una dirección que solo contiene regionCode y addressLines, y luego realizar la codificación geográfica es la manera recomendada de controlar direcciones sin estructura alguna (en lugar de inferir 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 durante los cuales esta ubicación está abierta. Contiene una colección de instancias de [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

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

object (TimePeriod)

Obligatorio. Un conjunto de horarios en los que esta ubicación está abierta. Cada período representa un rango de horas en las que la ubicación está abierta durante la semana.

TimePeriod

Representa el período durante el cual la empresa está abierta, desde el día y horario de apertura especificados hasta el cierre del día y la hora de cierre especificados. La hora de cierre debe ser posterior a la hora 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 el day of the week en el que comienza este período.
openTime

object (TimeOfDay)

Obligatorio. Los valores válidos son 00:00-24:00, donde 24:00 representa la medianoche al final del campo de día especificado.
closeDay

enum (DayOfWeek)

Obligatorio. Indica el day of the week el día en el que finaliza este período.
closeTime

object (TimeOfDay)

Obligatorio. Los valores válidos son 00:00-24:00, donde 24:00 representa la medianoche al final del campo de día especificado.

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 bisiestos. 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 del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.
seconds

integer

Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 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 normal.

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

object (SpecialHourPeriod)

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

SpecialHourPeriod

Representa un período único en el que el horario de atención de una ubicación difiere de su horario de atención normal. Un período especial de hora debe representar un intervalo inferior a 24 horas. openTime y startDate deben ser anteriores a closeTime y endDate. closeTime y endDate se pueden extender hasta las 11:59 a.m. del día posterior al startDate especificado. 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. La fecha calendario en la que comienza este período de hora especial.
openTime

object (TimeOfDay)

Opcional. Los valores válidos son 00:00-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. La fecha calendario en la que finaliza este período de hora especial. Si no se configura el campo endDate, se usará la fecha predeterminada en la fecha especificada en startDate. Si se establece, este campo debe ser igual o máximo 1 día después de startDate.
closeTime

object (TimeOfDay)

Opcional. Los valores válidos son 00:00-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 ignorarán endDate, openTime y closeTime, y la fecha especificada en startDate se considerará como la ubicación que permanecerá cerrada 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 prestan su servicio 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 del área de servicio
places

object (Places)

El área en la que presta servicio esta empresa se define mediante un conjunto de lugares.
regionCode

string

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

Este campo es obligatorio para las empresas CUSTOMER_LOCATION_ONLY y, de lo contrario, se ignora.

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

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

BusinessType

Indica si esta empresa solo ofrece servicios in situ en la ubicación de un cliente (por ejemplo, remolque) o en una dirección y en las instalaciones (por ejemplo, una pizzería con comedor, que también hace entregas a los clientes).

Enumeraciones
BUSINESS_TYPE_UNSPECIFIED Solo salida. No se especifica.
CUSTOMER_LOCATION_ONLY Ofrece servicios solo en los alrededores (no en la dirección de la empresa). Si se está actualizando una empresa de CUSTOMER_AND_BUSINESS_LOCATION a CUSTOMER_LOCATION_ONLY, la actualización de ubicación debe incluir la máscara de campo storefrontAddress y establecer el campo como vacío.
CUSTOMER_AND_BUSINESS_LOCATION Ofrece servicio en la dirección de la empresa y en sus alrededores.

Places

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

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

object (PlaceInfo)

Las áreas representadas por los IDs de lugar. El límite es 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. 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 o no en este momento. Todas las ubicaciones están abiertas de forma predeterminada, a menos que se actualicen para estar cerradas.
canReopen

boolean

Solo salida. Indica si esta empresa es apta para su reapertura.
openingDate

object (Date)

Opcional. Indica la fecha en que se abrió la ubicación por primera vez. Si no se conoce el día exacto, solo se puede proporcionar el mes y el año. La fecha debe ser en el pasado o no más de un año en el futuro.

OpenForBusiness

Indica el estado de una ubicación.

Enumeraciones
OPEN_FOR_BUSINESS_UNSPECIFIED No se especifica.
OPEN Indica que la ubicación está abierta.
CLOSED_PERMANENTLY Indica que la ubicación se cerró de forma permanente.
CLOSED_TEMPORARILY Indica que la ubicación se cerró temporalmente.

Metadatos

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

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
}
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

boolean

Solo salida. Indica si la ficha puede administrar publicaciones locales.
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 incluir un menú de comida.
canOperateHealthData

boolean

Solo salida. Indica si la ubicación puede funcionar con datos de Health.
canOperateLodgingData

boolean

Solo salida. Indica si la ubicación puede funcionar con datos de alojamientos.
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 las de actualización.
duplicateLocation

string

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

string

Solo salida. Es 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 llamadas a empresas.
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.

Perfil

Toda la información relativa al perfil de la ubicación.

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

string

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

RelationshipData

Información de todas las ubicaciones de madres, padres y de sus hijos o hijas relacionadas con esta

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

object (RelevantLocation)

La ubicación superior con la que tiene relación esta ubicación.
childrenLocations[]

object (RelevantLocation)

Es la lista de ubicaciones secundarias con las que tiene relación esta ubicación.
parentChain

string

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 cualquiera de DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF, y la ubicación especificada aquí puede estar a cualquiera de los lados (principal/secundario) de la ubicación.

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

string

Obligatorio. Especifica la ubicación que está del 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.

Enumeraciones
RELATION_TYPE_UNSPECIFIED Indica un tipo no especificado.
DEPARTMENT_OF Representa una relación entre 2 ubicaciones que comparten un área física y la misma marca, alta administración o organización, pero con atributos clave diferentes, como el horario de atención de la tienda 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 están ubicadas conjuntamente en la misma ubicación física, pero de diferentes empresas (p.ej., Starbucks en una caja fuerte, tiendas en un centro comercial).

MoreHours

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

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

string

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

object (TimePeriod)

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

ServiceItem

Un mensaje que describe un solo elemento de servicio. Se utiliza para describir el tipo de servicio que ofrece el comercio. Por ejemplo, el corte de pelo puede ser un servicio.

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

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Campos
price

object (Money)

Opcional. Representa el precio monetario del elemento de servicio. Recomendamos que se establezcan currencyCode y units cuando se incluya un precio. Se considerará un precio fijo para el elemento de servicio.
Campo de unión service_item_info. Siempre se debe establecer uno de los siguientes campos. Las direcciones (service_item_info) solo pueden ser una de las siguientes opciones:
structuredServiceItem

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

Opcional. Este campo establecerá el caso de los datos de servicios de formato libre.

StructuredServiceItem

Representa un servicio estructurado que ofrece el comercio. P. ej., “instalación_de_inodoros”.

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. El servicio rpc de categories.batchGet proporciona esta información.
description

string

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

FreeFormServiceItem

Representa un servicio de formato libre que ofrece el comercio. Estos son servicios que no se exponen como parte de los datos de servicio de nuestra estructura. El comercio ingresa manualmente los nombres de esos servicios a través de una plataforma de comercio geográfico.

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 elementos category y serviceTypeId deben coincidir con las posibles combinaciones que se proporcionan en el mensaje Category.
label

object (Label)

Obligatorio. Etiquetas de idioma del elemento etiquetadas. Recomendamos que los nombres de los artículos tengan 140 caracteres o menos, y las descripciones, 250 caracteres o menos. Este campo solo debe establecerse si la entrada es un elemento de servicio personalizado. Los tipos de servicios estandarizados se deben actualizar a través de serviceTypeId.

Etiqueta

Es la etiqueta que se usa cuando se muestra 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 artículo.
description

string

Opcional. 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 configurar 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", entonces 1 unidad es 1 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 que accedió.

list

 Muestra una lista de las ubicaciones de la cuenta especificada.