- Recurso: Ubicación
- Representación JSON
- PhoneNumbers
- Categorías
- Categoría
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Fecha
- ServiceAreaBusiness
- BusinessType
- Lugares
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Metadatos
- Perfil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Etiqueta
- Dinero
- Métodos
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 ( |
Campos | |
---|---|
name |
Es el identificador de Google para esta ubicación con el formato: |
languageCode |
Inmutable. El idioma de la ubicación. Se establece durante la creación y no se puede actualizar. |
storeCode |
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 |
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, |
phoneNumbers |
Opcional. Los distintos números de teléfono que pueden usar los clientes para comunicarse con la empresa |
categories |
Opcional. Las diferentes categorías que describen a la empresa. |
storefrontAddress |
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 |
websiteUri |
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 |
Opcional. Es el horario de atención de la empresa. |
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 |
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[] |
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 |
Opcional. Es la información adicional que se muestra en AdWords. |
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 |
openInfo |
Opcional. Una marca que indica si la ubicación está abierta actualmente. |
metadata |
Solo salida. Información adicional que no puede editar el usuario. |
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 |
Opcional. Todas las ubicaciones y cadenas relacionadas con esta. |
moreHours[] |
Opcional. Más horarios para los diferentes departamentos o clientes específicos de una empresa. |
serviceItems[] |
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. |
PhoneNumbers
Una colección de números de teléfono de la empresa. Durante las actualizaciones, ambos campos deben configurarse. 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". 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 |
Obligatorio. Un número de teléfono que se comunica 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[] |
Opcional. Hasta dos números de teléfono (teléfono celular o fijo, no fax), además del 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, ambos campos deben configurarse. Los clientes tienen prohibido actualizar individualmente las categorías principales o adicionales con la máscara de actualización.
Representación JSON |
---|
{ "primaryCategory": { object ( |
Campos | |
---|---|
primaryCategory |
Obligatorio. Categoría que mejor describe la empresa principal en la que participa esta ubicación. |
additionalCategories[] |
Opcional. Categorías adicionales para describir tu empresa. Las categorías ayudan a los clientes a encontrar resultados precisos y específicos sobre los servicios que les interesan. Para mantener la precisión y vigencia de la información de tu empresa, asegúrate de utilizar la menor cantidad posible de categorías para describir tu actividad comercial principal de forma general. Selecciona categorías que sean lo más específicas posible, pero que, a su vez, sean representativas de tu actividad comercial principal. |
Categoría
Una categoría que describa qué es esta empresa (no qué hace). Para obtener una lista de los IDs de categoría válidos y las asignaciones a sus nombres legibles, consulta categories.list
.
Representación JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Campos | |
---|---|
name |
Obligatorio. 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 |
Solo salida. Es el nombre legible de la categoría. Esto se establece cuando se lee la ubicación. Cuando se modifica la ubicación, se debe establecer |
serviceTypes[] |
Solo salida. Una lista de todos los tipos de servicios disponibles para esta categoría de empresa. |
moreHoursTypes[] |
Solo salida. Más tipos de horarios disponibles para esta categoría de empresa. |
ServiceType
Un mensaje que describe un tipo de servicio que ofrece la empresa.
Representación JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
Campos | |
---|---|
serviceTypeId |
Solo salida. Un ID estable (proporcionado por Google) para este tipo de servicio. |
displayName |
Solo salida. Es el nombre visible y legible del tipo de servicio. |
MoreHoursType
Más tipos de horarios que una empresa puede ofrecer, además de sus horarios habituales.
Representación JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Campos | |
---|---|
hoursTypeId |
Solo salida. Un ID estable proporcionado por Google para este tipo de horario. |
displayName |
Solo salida. Es el nombre visible en inglés legible para el tipo de horario. |
localizedDisplayName |
Solo salida. Es el nombre visible localizado y legible 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 listo 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 |
La revisión del esquema de Todas las revisiones nuevas deben ser compatibles con las revisiones anteriores. |
regionCode |
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. Para obtener más información, consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza. |
languageCode |
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 |
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 |
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 del sector" (Jamaica), el "indicador del área de entrega" (Malaui) o el "indicador de oficina de correo" (p.ej., Costa de Marfil). |
administrativeArea |
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, es la provincia y no 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 |
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 |
Opcional. Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos. |
addressLines[] |
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 (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[] |
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 |
Opcional. El nombre de la organización de la dirección. |
BusinessHours
Representa los períodos en los que esta ubicación está abierta para la empresa. Contiene una colección de instancias de [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Representación JSON |
---|
{
"periods": [
{
object ( |
Campos | |
---|---|
periods[] |
Obligatorio. 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 un período durante el cual la empresa estará abierta, desde el día y la hora de apertura especificados y hasta el cierre en el día o la hora de cierre especificados. El horario de cierre debe ser posterior al horario de apertura, por ejemplo, en el mismo día o en un día posterior.
Representación JSON |
---|
{ "openDay": enum ( |
Campos | |
---|---|
openDay |
Obligatorio. Indica el |
openTime |
Obligatorio. Los valores válidos son 00:00-24:00, en el que 24:00 representa la medianoche al final del campo de día especificado. |
closeDay |
Obligatorio. Indica el |
closeTime |
Obligatorio. Los valores válidos son 00:00-24:00, en el que 24:00 representa la medianoche al final del campo de día especificado. |
DayOfWeek
Representa un día de la semana.
Enumeradores | |
---|---|
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 |
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 |
Minutos de horas del día. Debe ser un valor entre 0 y 59. |
seconds |
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 |
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 ( |
Campos | |
---|---|
specialHourPeriods[] |
Obligatorio. Una lista de excepciones al horario de atención habitual de la empresa |
SpecialHourPeriod
Representa un período único en el que el horario de atención de una ubicación difiere del horario de atención normal. Un período especial debe representar un intervalo de menos de 24 horas. openTime
y startDate
deben ser anteriores a closeTime
y endDate
. closeTime
y endDate
pueden extenderse hasta las 11:59 a.m. del día después de 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 ( |
Campos | |
---|---|
startDate |
Obligatorio. La fecha calendario en la que comienza este período especial. |
openTime |
Opcional. Los valores válidos son 00:00-24:00, en el que 24:00 representa la medianoche al final del campo de día especificado. Se debe especificar si |
endDate |
Opcional. La fecha calendario en la que finaliza este horario especial. Si no se configura el campo |
closeTime |
Opcional. Los valores válidos son 00:00-24:00, en el que 24:00 representa la medianoche al final del campo de día especificado. Se debe especificar si |
closed |
Opcional. Si es verdadero, se ignoran |
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 no son significativas. La fecha está relacionada con el calendario gregoriano. Esto puede representar una de las siguientes opciones:
- Una fecha completa con valores de año, mes y día que no sean cero
- Es un mes y un día con un año cero (por ejemplo, un aniversario).
- Un año 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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe encontrarse entre 1 y 9999, o bien entre 0 para especificar una fecha sin año. |
month |
Mes del año Debe encontrarse entre 1 y 12, o bien 0 para especificar un año sin mes ni día. |
day |
Día del mes. Debe encontrarse entre 1 y 31 y ser válido para el año y el mes, o bien 0 para especificar solo un año o un año y mes en los que el día no sea importante. |
ServiceAreaBusiness
Las empresas de servicio en el área ofrecen servicios en la ubicación del cliente (por ejemplo, cerrajero o plomero).
Representación JSON |
---|
{ "businessType": enum ( |
Campos | |
---|---|
businessType |
Obligatorio. Indica el [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] de la empresa de área de servicio. |
places |
El área a la que presta servicios esta empresa se define a través de un conjunto de lugares. |
regionCode |
Inmutable. Es el código regional de CLDR del país o la región donde se encuentra esta empresa de servicio en área. 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 que operan con CUSTOMER_LOCATION_ONLY; 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 de aquella en la que se encuentran). Si esta ubicación requiere verificación después de su creación, la dirección proporcionada con fines de verificación debe estar 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, un camión de 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).
Enumeradores | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Solo salida. No se especifica. |
CUSTOMER_LOCATION_ONLY |
Ofrece servicio solo en los alrededores (no en la dirección de la empresa). Si se actualiza 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 los alrededores. |
Places
Define la unión de áreas representadas por un conjunto de lugares.
Representación JSON |
---|
{
"placeInfos": [
{
object ( |
Campos | |
---|---|
placeInfos[] |
Las áreas representadas por los IDs de lugar. Límite de 20 lugares. |
PlaceInfo
Define un área representada por un ID de lugar.
Representación JSON |
---|
{ "placeName": string, "placeId": string } |
Campos | |
---|---|
placeName |
Obligatorio. El nombre localizado del lugar. Por ejemplo, |
placeId |
Obligatorio. El ID del lugar. Debe corresponder a una región. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Es la información adicional que se muestra en AdWords.
Representación JSON |
---|
{ "adPhone": string } |
Campos | |
---|---|
adPhone |
Obligatorio. Un número de teléfono alternativo para mostrar 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 |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
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 ( |
Campos | |
---|---|
status |
Obligatorio. Indica si la ubicación está abierta en este momento. Todas las ubicaciones están abiertas de forma predeterminada, a menos que se actualice para que estén cerradas. |
canReopen |
Solo salida. Indica si este negocio es apto para su reapertura. |
openingDate |
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 no puede ser anterior a la actual o no debe ser posterior a un año. |
OpenForBusiness
Indica el estado de una ubicación.
Enumeradores | |
---|---|
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. |
Metadata
Información adicional sobre la ubicación que no puede editar el usuario
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 |
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 |
hasPendingEdits |
Solo salida. Indica si alguna de las propiedades de esta ubicación está en estado de edición pendiente. |
canDelete |
Solo salida. Indica si la ubicación se puede borrar con la API. |
canOperateLocalPost |
Solo salida. Indica si la ficha puede administrar publicaciones locales. |
canModifyServiceList |
Solo salida. Indica si la ficha puede modificar la lista de servicios. |
canHaveFoodMenus |
Solo salida. Indica si la ficha es apta para el menú de comida. |
canOperateHealthData |
Solo salida. Indica si la ubicación puede operar en datos de salud. |
canOperateLodgingData |
Solo salida. Indica si la ubicación puede operar con datos de alojamiento. |
placeId |
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 configurar durante las llamadas de creación, pero no para Update. |
duplicateLocation |
Solo salida. El recurso de ubicación que duplica esta ubicación. |
mapsUri |
Solo salida. Un vínculo a la ubicación en Maps |
newReviewUri |
Solo salida. Es un vínculo a la página en la Búsqueda de Google en la que un cliente puede dejar una opinión sobre la ubicación. |
canHaveBusinessCalls |
Solo salida. Indica si la ficha es apta para llamadas a empresas. |
hasVoiceOfMerchant |
Solo salida. Indica si la ficha tiene Voice of Merchant. Si este valor booleano es falso, debes llamar a la API de locations.getVoiceOfMerchantState para obtener detalles sobre por qué no tiene Voice of Merchant. |
Perfil
Toda la información relativa al perfil de la ubicación
Representación JSON |
---|
{ "description": string } |
Campos | |
---|---|
description |
Obligatorio. Es la descripción de la ubicación con tu propia voz; nadie más puede editarla. |
RelationshipData
Información de todas las ubicaciones de madres, padres y de niños relacionadas con esta.
Representación JSON |
---|
{ "parentLocation": { object ( |
Campos | |
---|---|
parentLocation |
La ubicación principal con la que tiene relaciones esta ubicación. |
childrenLocations[] |
Es la lista de ubicaciones secundarias con las que tiene relación esta ubicación. |
parentChain |
El nombre del recurso de la cadena de la que es miembro esta ubicación. [Cómo encontrar el ID de la cadena] [Locations.SearchChains] |
RelevantLocation
Incluye información sobre otra ubicación relacionada con la ubicación actual. La relación puede ser cualquiera de DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF, y la ubicación especificada aquí puede estar a ambos lados (principal/secundaria) de la ubicación.
Representación JSON |
---|
{
"placeId": string,
"relationType": enum ( |
Campos | |
---|---|
placeId |
Obligatorio. Especifica la ubicación que está al otro lado de la relación por su placeID. |
relationType |
Obligatorio. Es el tipo de relación. |
RelationType
Las relaciones de tipo que se especificarán.
Enumeradores | |
---|---|
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, organización o administración superior, pero con diferentes atributos clave, como el horario de atención o los números de teléfono. Por ejemplo, Farmacia Costco es un departamento en Costco Wholesale. |
INDEPENDENT_ESTABLISHMENT_IN |
Esto representa los casos en los que 2 ubicaciones están ubicadas en la misma ubicación física, pero de empresas diferentes (p.ej., Starbucks en un Safeway o 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 ( |
Campos | |
---|---|
hoursTypeId |
Obligatorio. Es el tipo de horario. Los clientes deben llamar a {#link businessCategories:BatchGet} para obtener los tipos de horario de atención admitidos en las categorías de sus ubicaciones. |
periods[] |
Obligatorio. 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 usa para describir el tipo de servicio que ofrece el comercio. Por ejemplo, corte de cabello puede ser un servicio.
Representación JSON |
---|
{ "price": { object ( |
Campos | |
---|---|
price |
Opcional. Representa el precio monetario del artículo de servicio. Recomendamos que se establezcan currencyCode y las unidades cuando se incluya un precio. Este se considerará como un precio fijo para el 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 |
Opcional. Este campo establecerá las mayúsculas y minúsculas de los datos de servicios estructurados. |
freeFormServiceItem |
Opcional. Este campo establecerá las mayúsculas y minúsculas de los datos de servicios de formato libre. |
StructuredServiceItem
Representa un servicio estructurado que ofrece el comercio. P. ej., instalación_de_inodoro.
Representación JSON |
---|
{ "serviceTypeId": string, "description": string } |
Campos | |
---|---|
serviceTypeId |
Obligatorio. El campo |
description |
Opcional. Es la descripción del elemento de servicio estructurado. El límite es de 300 caracteres. |
FreeFormServiceItem
Representa un servicio de formato libre que ofrece el comercio. Estos son servicios que no se exponen como parte de los datos de nuestros servicios de estructura. El comercio ingresa manualmente los nombres de esos servicios en una plataforma de geocomercio.
Representación JSON |
---|
{
"category": string,
"label": {
object ( |
Campos | |
---|---|
category |
Obligatorio. Este campo representa el nombre de la categoría (es decir, el ID estable de la categoría). |
label |
Obligatorio. Son las etiquetas etiquetadas con el idioma del elemento. Se recomienda que los nombres de los elementos tengan 140 caracteres o menos y que las descripciones tengan 250 caracteres o menos. Este campo solo se debe configurar si la entrada es un elemento de servicio personalizado. Los tipos de servicios estandarizados se deben actualizar mediante 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 |
Obligatorio. Es el nombre visible de la lista de precios, la sección o el artículo. |
description |
Opcional. Es la descripción de la lista de precios, la sección o el artículo. |
languageCode |
Opcional. 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 |
El código de moneda de tres letras definido en ISO 4217. |
units |
La unidad entera del importe. Por ejemplo, si |
nanos |
Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si |
Métodos |
|
---|---|
|
Crea una nueva ubicación que será propiedad del usuario conectado. |
|
Muestra una lista de las ubicaciones de la cuenta especificada. |