REST Resource: accounts.locations

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

string

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.

string

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

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

object (Category)

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

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

string

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

string

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 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 y legible del tipo de servicio.

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

string

Solo salida. Un ID estable proporcionado por Google para este tipo de horario.

string

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

string

Solo salida. Es el nombre visible localizado y legible 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. 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.

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 del sector" (Jamaica), el "indicador del área de entrega" (Malaui) o el "indicador de oficina de correo" (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, 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.

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

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. 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, en el que 24:00 representa la medianoche al final del campo de día especificado.

enum (DayOfWeek)

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

object (TimeOfDay)

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.

{
  "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. Una lista de excepciones al horario de atención 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 especial.

object (TimeOfDay)

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

object (Date)

Opcional. La fecha calendario en la que finaliza este horario especial. Si no se configura el campo endDate, se utilizará la fecha especificada en startDate de forma predeterminada. Si se configura, este campo debe ser igual o como máximo 1 día después de startDate.

object (TimeOfDay)

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

boolean

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

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

integer

Año de la fecha. Debe encontrarse entre 1 y 9999, o bien entre 0 para especificar una fecha sin año.

integer

Mes del año Debe encontrarse entre 1 y 12, o bien 0 para especificar un año sin mes ni día.

integer

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.

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

enum (BusinessType)

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

object (Places)

El área a la que presta servicios esta empresa se define a través de un conjunto de lugares.

string

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.

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

object (PlaceInfo)

Las áreas representadas por los IDs de lugar. Límite de 20 lugares.

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

string

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

{
  "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 en este momento. Todas las ubicaciones están abiertas de forma predeterminada, a menos que se actualice para que estén cerradas.

boolean

Solo salida. Indica si este negocio es apto 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 no puede ser anterior a la actual o no debe ser posterior a un año.

{
  "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 deba verificar.

boolean

Solo salida. Indica si alguna de las propiedades de esta ubicación está 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 el menú de comida.

boolean

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

boolean

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

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 configurar durante las llamadas de creación, pero no para Update.

string

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

string

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

string

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.

boolean

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

boolean

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.

{
  "description": string
}

string

Obligatorio. Es la descripción de la ubicación con tu propia voz; nadie más puede editarla.

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

object (RelevantLocation)

La ubicación principal con la que tiene relaciones 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 de la que es miembro 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á al 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. 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.

object (TimePeriod)

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.

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

object (StructuredServiceItem)

Opcional. Este campo establecerá las mayúsculas y minúsculas de los datos de servicios estructurados.

object (FreeFormServiceItem)

Opcional. Este campo establecerá las mayúsculas y minúsculas 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 de rpc de categories.batchGet proporciona esta información.

string

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

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

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

{
  "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. Es la descripción de la lista de precios, la sección o el artículo.

string

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

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

string

El código de moneda de tres letras definido en 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.