REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

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.

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.

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

Obligatorio. Es la categoría que mejor describe la empresa principal en la que participa esta ubicación.

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

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

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

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.

object (ServiceType)

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

object (MoreHoursType)

Solo salida. Más tipos de horarios disponibles para esta categoría de empresa.

{
  "serviceTypeId": string,
  "displayName": string
}

string

Solo salida. Un ID estable (proporcionado por Google) para este tipo de servicio.

string

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

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

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

string

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

string

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

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

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.

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.

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

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

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

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.

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.

string

Opcional: Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos.

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

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

string

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

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

enum (DayOfWeek)

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

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.

enum (DayOfWeek)

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

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.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

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.

integer

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

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.

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

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

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

Obligatorio. La fecha calendario en la que comienza este período de hora especial.

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.

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.

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.

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.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

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.

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.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

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

object (Places)

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

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.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

Las áreas representadas por los IDs de lugar. El límite es de 20 lugares.

{
  "placeName": string,
  "placeId": string
}

string

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

string

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

{
  "adPhone": string
}

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.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

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.

boolean

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

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.

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

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.

boolean

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

boolean

Solo salida. Indica si la ubicación se puede borrar con la API.

boolean

Solo salida. Indica si la ficha puede administrar publicaciones locales.

boolean

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

boolean

Solo salida. Indica si la ficha es apta para incluir un menú de comida.

boolean

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

boolean

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

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.

string

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

string

Solo salida. Es un vínculo a la ubicación en Maps.

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.

boolean

Solo salida. Indica si la ficha es apta para llamadas a empresas.

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.

{
  "description": string
}

string

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

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

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

object (RelevantLocation)

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

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]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

Obligatorio. Especifica la ubicación que está del otro lado de la relación por su placeID.

enum (RelationType)

Obligatorio. Es el tipo de relación.

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

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.

{
  "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.
}

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.

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

{
  "serviceTypeId": string,
  "description": string
}

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.

string

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

{
  "category": string,
  "label": {
    object (Label)
  }
}

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.

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.

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

Obligatorio. Es el nombre visible de la lista de precios, la sección o el artículo.

string

Opcional. Descripción de la lista de precios, la sección o el artículo.

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.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

string (int64 format)

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

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.