Package google.mybusiness.businessinformation.v1

Índice

AttributesService

Permite a los clientes buscar y actualizar atributos de una ubicación determinada.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Busca todos los atributos configurados para una ubicación determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Obtiene la versión actualizada por Google de la ubicación especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Muestra la lista de atributos que estarían disponibles para una ubicación con la categoría principal y el país especificados.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Actualiza los atributos de una ubicación determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

CategoriesService

Esta API proporciona información sobre las categorías admitidas para las ubicaciones de la empresa en Google. Para obtener más información, consulta la sección de categorías de este artículo: https://support.google.com/business/answer/3038177.

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Muestra una lista de categorías de empresas para el idioma y los IDs de GConcept proporcionados.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

Muestra una lista de categorías de empresas. La búsqueda coincidirá con el nombre de la categoría, pero no con el ID de la categoría.

La búsqueda solo coincide con la parte delantera del nombre de una categoría (es decir, 'comida' puede mostrar 'Comida', pero no 'Restaurante de comida rápida').

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

Cadenas

Un servicio para buscar información sobre una empresa de cadena.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Obtiene la cadena especificada. Muestra NOT_FOUND si la cadena no existe.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Busca la cadena según su nombre.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

GoogleLocations

Esta API permite acceder a GoogleLocation y realizar búsquedas en él.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Buscar todas las ubicaciones posibles que coincidan con la solicitud especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

Ubicaciones

Esta API permite administrar las ubicaciones de la empresa en Google.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Crea una nueva ubicación que será propiedad del usuario conectado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Borra una ubicación.

Si esta ubicación no se puede borrar con la API y está marcada en google.mybusiness.businessinformation.v1.LocationState, usa el sitio web del Perfil de Negocio de Google.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Obtiene la versión actualizada por Google de la ubicación especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Muestra la ubicación especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Muestra una lista de las ubicaciones de la cuenta especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Actualiza la ubicación especificada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la Descripción general de OAuth 2.0.

AdWordsLocationExtensions

Es la información adicional que se muestra en AdWords.

Campos
ad_phone

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.

Atributo

Un atributo de ubicación. Los atributos proporcionan información adicional sobre una ubicación. Los atributos que se pueden establecer en una ubicación pueden variar según las propiedades de esa ubicación (por ejemplo, la categoría). Google determina los atributos disponibles, y se pueden agregar y quitar sin cambios en la API.

Campos
name

string

Obligatorio. El nombre del recurso para este atributo.

value_type

AttributeValueType

Solo salida. Es el tipo de valor que contiene este atributo. Se debe usar para determinar cómo interpretar el valor.

values[]

Value

Son los valores de este atributo. El tipo de valores proporcionados debe coincidir con el valor esperado para ese atributo. Este es un campo repetido en el que se pueden proporcionar múltiples valores de atributo. Los tipos de atributo solo admiten un valor.

repeated_enum_value

RepeatedEnumAttributeValue

Cuando el tipo de valor del atributo es REPEATED_ENUM, este contiene el valor del atributo y los demás campos de valores deben estar vacíos.

uri_values[]

UriAttributeValue

Cuando el tipo de valor del atributo es URL, este campo contiene los valores de este atributo y los demás campos de valores deben estar vacíos.

AttributeMetadata

Son los metadatos de un atributo. Contiene información de visualización del atributo, como un nombre localizado y un encabezado para agrupar los atributos relacionados.

Campos
parent

string

Es el identificador único del atributo.

value_type

AttributeValueType

Es el tipo de valor del atributo. Se espera que los valores establecidos y recuperados sean de este tipo.

display_name

string

El nombre visible localizado del atributo, si está disponible; de lo contrario, es el nombre visible en inglés.

group_display_name

string

El nombre visible localizado del grupo que contiene este atributo, si está disponible; de lo contrario, el nombre del grupo en inglés. Los atributos relacionados se recopilan en un grupo y deben mostrarse juntos bajo el encabezado que se proporciona aquí.

repeatable

bool

Si es verdadero, el atributo admite varios valores. Si es falso, se debe proporcionar un solo valor.

value_metadata[]

AttributeValueMetadata

Para algunos tipos de atributos (por ejemplo, enumeraciones), se proporciona una lista de los valores admitidos y los nombres visibles correspondientes a esos valores.

deprecated

bool

Si es verdadero, el atributo deja de estar disponible y no debe usarse más. Si es obsoleto, la actualización de este atributo no generará errores, pero no se guardarán las actualizaciones. Después de que este deje de estar disponible, se quitará por completo y se convertirá en un error.

AttributeValueMetadata

Metadatos de los valores de atributos admitidos.

Campos
value

Value

Es el valor del atributo.

display_name

string

Es el nombre visible de este valor, localizado cuando esté disponible; de lo contrario, debe estar en inglés. El nombre visible del valor se diseñó para usarse en contexto con el nombre visible del atributo.

Por ejemplo, para un atributo de enumeración "Wi-Fi", podría incluir "Pagado" para representar la red Wi-Fi pagada.

AttributeValueType

El tipo de valor del atributo.

Enumeradores
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED No se especifica.
BOOL Los valores de este atributo son booleanos.
ENUM El atributo tiene una lista predeterminada de valores disponibles que se pueden usar. En los metadatos de este atributo, se incluyen estos valores.
URL Los valores de este atributo son URL.
REPEATED_ENUM El valor del atributo es una enumeración con varios valores posibles que se pueden configurar o no configurar de forma explícita.

Atributos

Es un contenedor para todos los atributos de una ubicación determinada.

Campos
name

string

Obligatorio. Es el identificador de Google para esta ubicación con el formato locations/{location_id}/attributes.

attributes[]

Attribute

Una colección de atributos que deben actualizarse.

BatchGetCategoriesRequest

Mensaje de solicitud para BusinessCategories.BatchGetBusinessCategories.

Campos
names[]

string

Obligatorio. Se debe establecer al menos un nombre. Son los ID de GConcept para los que se deben mostrar los nombres de categorías localizadas. Para que se muestren detalles de más de una categoría, repite este parámetro en la solicitud.

language_code

string

Obligatorio. Es el código del idioma BCP 47 en el que se deben mostrar los nombres de categorías.

region_code

string

Opcional. Es el código de país ISO 3166-1 alpha-2 utilizado para inferir un idioma no estándar.

view

CategoryView

Obligatorio. Especifica qué partes del recurso Category se deben mostrar en la respuesta.

BatchGetCategoriesResponse

Mensaje de respuesta para BusinessCategories.BatchGetBusinessCategories.

Campos
categories[]

Category

Categorías que coinciden con los IDs de GConcept proporcionados en la solicitud. No tendrán el mismo orden que los IDs de categoría de la solicitud.

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

Campos
periods[]

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.

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.

Campos
primary_category

Category

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

additional_categories[]

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.

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.

Campos
name

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

display_name

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.

service_types[]

ServiceType

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

more_hours_types[]

MoreHoursType

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

CategoryView

Una enumeración para ayudar a limitar la cantidad de datos que muestra el servidor.

Enumeradores
CATEGORY_VIEW_UNSPECIFIED No se especifica. Equivale a CATEGORY_METADATA_ONLY.
BASIC La respuesta del servidor solo incluirá los campos Category, display_name, category_id y language_code. Omite todos los campos relacionados con metadatos de tipo de servicio.
FULL Muestra todos los campos de la respuesta.

Cadena

Una cadena es una marca a la que se pueden asociar las ubicaciones de tu empresa.

Campos
name

string

Obligatorio. El nombre del recurso de la cadena, en formato chains/{chain_id}

chain_names[]

ChainName

Son los nombres de la cadena.

websites[]

ChainUri

Los sitios web de la cadena

location_count

int32

Cantidad de ubicaciones que forman parte de esta cadena.

ChainName

Nombre que se usará para mostrar la cadena.

Campos
display_name

string

El nombre visible de esta cadena.

language_code

string

Es el código de idioma BCP 47 del nombre.

ChainUri

Es la URL que se usará para mostrar la cadena.

Campos
uri

string

El URI de esta cadena.

CreateLocationRequest

Mensaje de solicitud para locations.CreateLocation.

Campos
parent

string

Obligatorio. El nombre de la cuenta en la que se creará esta ubicación.

location

Location

Obligatorio. Los nuevos metadatos de ubicación.

validate_only

bool

Opcional. Si es verdadero, la solicitud se valida sin crear la ubicación.

request_id

string

Opcional. Un ID de solicitud único para que el servidor detecte solicitudes duplicadas. Recomendamos usar UUID. La longitud máxima es de 50 caracteres.

DeleteLocationRequest

Mensaje de solicitud para locations.DeleteLocation.

Campos
name

string

Obligatorio. El nombre de la ubicación que se borrará.

ErrorCode

Todos los códigos de error que muestra la API.

Enumeradores
ERROR_CODE_UNSPECIFIED Falta el código de error.
INVALID_ATTRIBUTE_NAME Uno de los atributos proporcionados no se puede aplicar a esta ubicación. Solo los atributos que se muestran en la respuesta de ListAttributeMetadata se pueden aplicar a esta ubicación. Todos los nombres de atributos problemáticos se mostrarán en la clave attribute_names, en los metadatos.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION Se muestra este error cuando un cliente intenta asociar una ubicación o borrar una asociación de ubicación en una ubicación que se encuentra en estado verificado.
ASSOCIATE_LOCATION_INVALID_PLACE_ID El place_id proporcionado en la solicitud associateLocation no coincide con la ubicación o no es válido. Asegúrate de que el place_id que se establezca coincida con uno de los IDs que se muestran en la respuesta SearchGoogleLocations.
LAT_LNG_UPDATES_NOT_PERMITTED Este proyecto no tiene permiso para actualizar el campo de latitud y longitud en la ubicación. Puedes actualizar los valores de latitud y longitud mediante la función de soltar en la IU o proporcionarnos una dirección.
PO_BOX_IN_ADDRESS_NOT_ALLOWED No se puede usar un apartado postal en la dirección. Las claves de metadatos incluyen “field_mask”.
BLOCKED_REGION Debido a las sanciones internacionales que estamos obligados a satisfacer, no podemos aceptar empresas de esta región. Las claves de metadatos incluyen “field_maks”.
MISSING_BOTH_PHONE_AND_WEBSITE Las empresas que se encuentran en CUSTOMER_LOCATION_ONLY requieren un teléfono o un sitio web. Las claves de metadatos incluyen “field_mask”.
MISSING_STOREFRONT_ADDRESS_OR_SAB Todas las ubicaciones deben tener al menos una dirección de establecimiento físico o un área de servicio. Las claves de metadatos incluyen “field_mask”.
LAT_LNG_TOO_FAR_FROM_ADDRESS El par latitud/longitud y dirección están demasiado separados. Las claves de metadatos incluyen “field_mask”.
LAT_LNG_REQUIRED OBSOLETO. Se reemplazó por PIN_DROP_REQUIRED. No se puede encontrar la dirección especificada. Proporciona los valores de latitud y longitud. Las claves de metadatos incluyen “field_mask”.
INVALID_CHARACTERS Se encontraron caracteres no válidos. Las claves de metadatos incluyen "field_mask" y "invalid_characters".
FORBIDDEN_WORDS Se encontraron palabras prohibidas. Las claves de metadatos incluyen “field_mask” y “forbidden_words”.
INVALID_INTERCHANGE_CHARACTERS Se encontraron caracteres no válidos. Las claves de metadatos incluyen “field_mask”.
FIELDS_REQUIRED_FOR_CATEGORY Se requieren campos adicionales para esta categoría de ubicación. Las claves de metadatos incluyen “field_mask”, “value” y “fields_required”.
STOREFRONT_REQUIRED_FOR_CATEGORY Tu categoría de empresa requiere una ubicación de tienda que los clientes puedan visitar. Las claves de metadatos incluyen “field_mask”.
ADDRESS_MISSING_REGION_CODE Falta el campo region_code obligatorio en la dirección. Las claves de metadatos incluyen “field_mask”.
ADDRESS_EDIT_CHANGES_COUNTRY La dirección no se puede mover a otro país. Las claves de metadatos incluyen “field_mask”.
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS El horario especial solo se puede especificar si la ubicación tiene un horario de atención habitual. Los metadatos están vacíos.
INVALID_TIME_SCHEDULE La programación de horas no es válida, la hora superpuesta o de finalización es anterior a la hora de inicio. Las claves de metadatos incluyen “field_mask”.
INVALID_HOURS_VALUE El valor o formato de las horas no es válido. Las claves de metadatos incluyen “field_mask”.
OVERLAPPED_SPECIAL_HOURS El campo Special_hours no puede superponerse. Las claves de metadatos incluyen “field_mask”.
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY Tu categoría principal de empresa no admite este tipo de horario de atención. Las claves de metadatos incluyen "field_mask" y "incompatible_hours_type".
DUPLICATE_CHILDREN_LOCATIONS Ubicaciones_secundarias duplicadas en connection_data Las claves de metadatos incluyen “field_mask”.
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY Una empresa de servicio en área no puede tener la categoría principal seleccionada. Las claves de metadatos incluyen “field_mask”.
INVALID_SERVICE_AREA_PLACE_ID El place_id de service_area no es válido. Las claves de metadatos incluyen "field_mask" y "place_id".
INVALID_AREA_TYPE_FOR_SERVICE_AREA El tipo de área para service_area no es válido. Las claves de metadatos incluyen "field_mask" y "place_id".
OPENING_DATE_TOO_FAR_IN_THE_FUTURE Ingresa una fecha de apertura que se encuentre dentro de un período de un año. Las claves de metadatos incluyen “field_mask”.
OPENING_DATE_MISSING_YEAR_OR_MONTH La fecha de apertura debe tener un año o un mes especificado. Las claves de metadatos incluyen “field_mask”.
OPENING_DATE_BEFORE_1AD La fecha de apertura no puede ser anterior al 1 AD. Las claves de metadatos incluyen “field_mask”.
TOO_MANY_ENTRIES Hay demasiadas entradas para el campo. Las claves de metadatos incluyen “field_mask” y “max_count”.
INVALID_PHONE_NUMBER No se reconoce la entrada de número de teléfono. Las claves de metadatos incluyen “field_mask” y “value”.
INVALID_PHONE_NUMBER_FOR_REGION El número de teléfono para la región no es válido. Las claves de metadatos incluyen “field_mask” y “value”.
MISSING_PRIMARY_PHONE_NUMBER Falta el número de teléfono principal. Las claves de metadatos incluyen “field_mask”.
THROTTLED No se puede actualizar el campo en este momento. Las claves de metadatos incluyen “field_mask” y “value”.
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA Ya no se admiten las áreas de servicio de radio de puntos. Las claves de metadatos incluyen “field_mask”.
INVALID_CATEGORY El ID de categoría no es válido. Las claves de metadatos incluyen “field_mask” y “value”.
CANNOT_REOPEN No se puede volver a abrir la empresa. Las claves de metadatos incluyen “field_mask”.
INVALID_BUSINESS_OPENING_DATE La fecha de inauguración de la empresa no es válida. Las claves de metadatos incluyen “field_mask”.
INVALID_LATLNG El valor de latlng no es válido. Las claves de metadatos incluyen “field_mask”.
PROFILE_DESCRIPTION_CONTAINS_URL La descripción de la empresa no puede contener una URL. Las claves de metadatos incluyen “field_mask”.
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION No se puede editar la descripción del perfil de la ubicación de alojamiento. Las claves de metadatos incluyen “field_mask”.
INVALID_URL El enlace no es válido. Las claves de metadatos incluyen “field_mask”.
INVALID_ADDRESS La dirección no es válida. Las claves de metadatos incluyen “field_mask”.
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain no puede ser la ubicación en sí. Las claves de metadatos incluyen “field_mask” y “value”.
RELATION_CANNOT_BE_THE_LOCATION_ITSELF La relación no puede ser la ubicación en sí misma. Las claves de metadatos incluyen “field_mask” y “value”.
MISSING_ADDRESS_COMPONENTS Falta un valor para los componentes de dirección. Las claves de metadatos incluyen “field_mask”.
READ_ONLY_ADDRESS_COMPONENTS No se pueden editar los componentes de la dirección de solo lectura. Las claves de metadatos incluyen “field_mask”.
STRING_TOO_LONG La cadena es demasiado larga. Las claves de metadatos incluyen “field_mask” y “max_length”.
STRING_TOO_SHORT La cadena es demasiado corta. Las claves de metadatos incluyen “field_mask” y “min_length”.
REQUIRED_FIELD_MISSING_VALUE Falta un valor en el campo obligatorio. Las claves de metadatos incluyen “field_mask”.
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED No se puede agregar ni editar la URL de un proveedor. Las claves de metadatos incluyen “attribute_name”.
ATTRIBUTE_INVALID_ENUM_VALUE Valor desconocido para el atributo enum. Las claves de metadatos incluyen “attribute_name”.
ATTRIBUTE_NOT_AVAILABLE El atributo escalable no es válido para esta ubicación. Las claves de metadatos incluyen “attribute_name”.
ATTRIBUTE_CANNOT_BE_REPEATED El atributo escalable solo se puede especificar una vez. Las claves de metadatos incluyen “attribute_name”.
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY El atributo escalable no es compatible con las categorías establecidas en la ubicación. Las claves de metadatos incluyen “attribute_name”.
ADDRESS_REMOVAL_NOT_ALLOWED No se permite quitar la dirección de tu empresa. Las claves de metadatos incluyen “field_mask”.
AMBIGUOUS_TITLE El mejor nombre es ambiguo para un idioma. Las claves de metadatos incluyen “field_mask”.
INVALID_CATEGORY_FOR_SAB Una ESA pura no puede tener gcids que sean subtipos de gcid:establishment_poi. Las claves de metadatos incluyen “field_mask” y “value”.
RELATION_ENDPOINTS_TOO_FAR Los extremos de relación están demasiado lejos entre sí. Las claves de metadatos incluyen “field_mask” y “value”.
INVALID_SERVICE_ITEM No se configuraron ni estructurados_service_item ni free_form_service_item. Las claves de metadatos incluyen “field_mask”.
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME A la etiqueta le falta el nombre visible. Las claves de metadatos incluyen “field_mask”.
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME El nombre visible no es único para todas las etiquetas de todas las listas de precios. Las claves de metadatos incluyen “field_mask”.
SERVICE_ITEM_LABEL_INVALID_UTF8 La etiqueta contiene símbolos UTF-8 no válidos. Las claves de metadatos incluyen “field_mask”.
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID Falta el campo category_id en free_form_service_item. Las claves de metadatos incluyen “field_mask”.
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL Falta la etiqueta en free_form_service_item. Las claves de metadatos incluyen “field_mask”.
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID Falta el campo service_type_id en estructurado_service_item. Las claves de metadatos incluyen “field_mask”.
INVALID_LANGUAGE El código de idioma no es válido. Las claves de metadatos incluyen “field_mask”.
PRICE_CURRENCY_MISSING Falta el código de moneda ISO 4217. Las claves de metadatos incluyen “field_mask”.
PRICE_CURRENCY_INVALID El código de moneda proporcionado no es válido según la norma ISO 4217. Las claves de metadatos incluyen “field_mask”.
SERVICE_TYPE_ID_DUPLICATE Los IDs de tipo de servicio no son únicos en la ubicación. Las claves de metadatos incluyen “field_mask”.
PIN_DROP_REQUIRED No se puede encontrar la dirección especificada. Usa la IU para proporcionar un marcador. Las claves de metadatos incluyen “field_mask”.
STALE_DATA Google actualizó uno o más elementos recientemente. En este momento, solo el propietario de esta empresa puede hacer cambios en los datos ubicados en "field"; visita business.google.com. Las claves de metadatos incluyen "field_mask".
PHONE_NUMBER_EDITS_NOT_ALLOWED El campo de número de teléfono se inhabilitó para esta ubicación y no se permite hacer cambios. Las claves de metadatos incluyen “field_mask”.
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION Existen más de una relación que modelan la relación lógica entre dos ubicaciones (p.ej., deperatación de, funciona). Las claves de metadatos incluyen “field_mask” y “value”.

GetAttributesRequest

Solicitud para AttributesService.GetAttributes.

Campos
name

string

Obligatorio. Es el identificador de Google para esta ubicación con el formato locations/{location_id}/attributes.

GetChainRequest

Mensaje de solicitud para locations.GetChain.

Campos
name

string

Obligatorio. El nombre del recurso de la cadena, en formato chains/{chain_place_id}

GetGoogleUpdatedAttributesRequest

Se solicitó AttributesService.GetGoogleUpdatedAttributes.

Campos
name

string

Obligatorio. Es el identificador de Google para esta ubicación con el formato locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

Solicita un mensaje a locations.GetGoogleUpdatedLocation.

Campos
name

string

Obligatorio. El nombre de la ubicación que se recuperará.

read_mask

FieldMask

Obligatorio. Máscara de lectura para especificar qué campos se mostrarán en la respuesta.

GetLocationRequest

Solicita un mensaje a locations.GetLocation.

Campos
name

string

Obligatorio. El nombre de la ubicación que se recuperará.

read_mask

FieldMask

Obligatorio. Máscara de lectura para especificar qué campos se mostrarán en la respuesta.

GoogleLocation

Representa un Location que está presente en Google. Puede ser una ubicación que haya reclamado el usuario o alguna otra persona, o que se haya rechazado.

Campos
name

string

Es el nombre del recurso de esta GoogleLocation, en el formato googleLocations/{googleLocationId}.

location

Location

La información de Location propagada de manera dispersa. Este campo se puede volver a usar en CreateLocation si ningún usuario lo reclamó.

request_admin_rights_uri

string

Una URL que redireccionará al usuario a la IU de solicitudes de derechos de administrador. Este campo solo está presente si algún usuario ya reclamó la ubicación, incluido el usuario actual.

GoogleUpdatedLocation

Representa una ubicación que fue modificada por Google.

Campos
location

Location

La versión actualizada por Google de esta ubicación.

diff_mask

FieldMask

Los campos que Google actualizó

pending_mask

FieldMask

Los campos con ediciones pendientes que aún no se enviaron a Maps ni a la Búsqueda

Etiqueta

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

Campos
display_name

string

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

description

string

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

language_code

string

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

ListAttributeMetadataRequest

Solicitud de AttributesService.ListAttributeMetadata.

Campos
parent

string

Es el nombre del recurso de la ubicación para buscar atributos disponibles. Si se establece este campo, los campos category_name, region_code, language_code y show_all no son obligatorios y no deben configurarse.

category_name

string

Es el ID estable de la categoría principal para encontrar atributos disponibles. Debe tener las categorías de formato/{category_id}.

region_code

string

Es el código de país ISO 3166-1 alpha-2 para encontrar los atributos disponibles.

language_code

string

Es el código de idioma BCP 47 en el que se deben obtener los nombres visibles de los atributos. Si este idioma no está disponible, se ofrecerán en inglés.

show_all

bool

Los metadatos de todos los atributos disponibles se muestran cuando este campo se establece en verdadero, sin tener en cuenta los campos parent y category_name. language_code y region_code son obligatorios cuando show_all se establece en true.

page_size

int32

La cantidad de atributos que se deben incluir por página. El valor predeterminado es 200 y el mínimo es 1.

page_token

string

Si se especifica, se recupera la siguiente página de metadatos de atributos.

ListAttributeMetadataResponse

Respuesta para AttributesService.ListAttributeMetadata.

Campos
attribute_metadata[]

AttributeMetadata

Es una colección de metadatos de atributos para los atributos disponibles.

next_page_token

string

Si la cantidad de atributos supera el tamaño de la página solicitado, este campo se propagará con un token para recuperar la siguiente página de atributos en una llamada posterior a attributes.list. Si no hay más atributos, este campo no estará presente en la respuesta.

ListCategoriesRequest

Mensaje de solicitud para BusinessCategories.ListCategories.

Campos
region_code

string

Obligatorio. Es el código de país ISO 3166-1 alpha-2.

language_code

string

Obligatorio. Es el código de idioma BCP 47.

filter

string

Opcional. Filtre la cadena del usuario. El único campo admitido es displayName. P. ej.: filter=displayName=foo.

page_size

int32

Opcional. Cuántas categorías se deben recuperar por página. El valor predeterminado es 100, el mínimo es 1 y el tamaño máximo de la página es 100.

page_token

string

Opcional. Si se especifica, se recuperará la siguiente página de categorías.

view

CategoryView

Obligatorio. Especifica qué partes del recurso Category se deben mostrar en la respuesta.

ListCategoriesResponse

Mensaje de respuesta para BusinessCategories.ListCategories.

Campos
categories[]

Category

Las categorías coincidentes se basan en los parámetros solicitados.

next_page_token

string

Si la cantidad de categorías supera el tamaño de página solicitado, este campo se propagará con un token para recuperar la siguiente página de categorías en una llamada posterior a ListCategories.

ListLocationsRequest

Mensaje de solicitud para locations.ListLocations.

Campos
parent

string

Obligatorio. El nombre de la cuenta desde la que se recuperan las ubicaciones. Si la cuenta principal de [Account] [google.mybusiness.accountmanagement.v1.Account] es [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL, solo se mostrarán las ubicaciones que son propiedad directa de la cuenta. De lo contrario, se mostrarán todas las ubicaciones a las que se pueda acceder desde la cuenta, ya sea de forma directa o indirecta.

page_size

int32

Opcional. Cantidad de ubicaciones para recuperar por página. Si no se establece, el valor predeterminado es 10. El mínimo es 1 y el tamaño máximo de la página es 100.

page_token

string

Opcional. Si se especifica, recupera la siguiente page de ubicaciones. Las llamadas anteriores a ListLocations muestran el token de la página cuando había más ubicaciones de las que caben en el tamaño de la página solicitado.

filter

string

Opcional. Un filtro que restringe las ubicaciones que se mostrarán. La respuesta solo incluye entradas que coinciden con el filtro. Si filter está vacío, se aplican restricciones y se recuperan todas las ubicaciones (paginadas) para la cuenta solicitada.

Para obtener más información sobre los campos válidos y ejemplos de uso, consulta la Guía Trabajar con datos de ubicación.

order_by

string

Opcional. Orden de clasificación para la solicitud. Los campos múltiples deben estar separados por comas, siguiendo la sintaxis SQL. El orden de clasificación predeterminado es ascendente. Para especificar el orden descendente, se debe agregar el sufijo "desc". Los campos válidos para order_by son title y store_code. Por ejemplo: "title, store_code desc" o "title" o "store_code desc"

read_mask

FieldMask

Obligatorio. Máscara de lectura para especificar qué campos se mostrarán en la respuesta.

ListLocationsResponse

Mensaje de respuesta para locations.ListLocations.

Campos
locations[]

Location

Las ubicaciones.

next_page_token

string

Si la cantidad de ubicaciones superó el tamaño de la página solicitada, este campo se propaga con un token para recuperar la página de ubicaciones siguiente en una llamada posterior a ListLocations. Si no hay más ubicaciones, este campo no está presente en la respuesta.

total_size

int32

La cantidad aproximada de ubicaciones de la lista, sin importar la paginación. Este campo solo se mostrará si se usa filter como parámetro de consulta.

Location

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.

Campos
name

string

Es el identificador de Google para esta ubicación con el formato: locations/{location_id}.

language_code

string

Inmutable. El idioma de la ubicación. Se establece durante la creación y no se puede actualizar.

store_code

string

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

string

Obligatorio. El nombre de la ubicación debe reflejar el nombre de tu empresa en el mundo real, es decir, debe coincidir con el nombre 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, Address, Categories). No agregues información innecesaria a tu nombre (por ejemplo, elige "Google" en lugar de "Google Inc. - Sede central corporativa de Mountain View"). No incluyas eslóganes de marketing, códigos de tienda, caracteres especiales, horarios o estado cerrado o abierto, números de teléfono, URLs de sitios web, información del producto o servicio, ubicación/dirección o instrucciones sobre cómo llegar, ni información de contención (por ejemplo, "Cajero automático del banco en Bariloche").

phone_numbers

PhoneNumbers

Opcional. Los distintos números de teléfono que pueden usar los clientes para comunicarse con la empresa

categories

Categories

Opcional. Las diferentes categorías que describen a la empresa.

storefront_address

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 address_lines en la dirección. Este campo solo debe configurarse para las empresas que tienen un establecimiento físico. Este campo no debe configurarse para ubicaciones de tipo CUSTOMER_LOCATION_ONLY, pero si se configura, se descartará cualquier valor proporcionado.

website_uri

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éricos que representen todas las ubicaciones o la marca.

regular_hours

BusinessHours

Opcional. Es el horario de atención de la empresa.

special_hours

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.

service_area

ServiceAreaBusiness

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[]

string

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.

ad_words_location_extensions

AdWordsLocationExtensions

Opcional. Es la información adicional que se muestra en AdWords.

latlng

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 se actualizó el valor latlng a través del sitio web del Perfil de Negocio de Google. Solo los clientes aprobados pueden actualizar este campo.

open_info

OpenInfo

Opcional. Una marca que indica si la ubicación está abierta actualmente.

metadata

Metadata

Solo salida. Información adicional que no puede editar el usuario.

profile

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

relationship_data

RelationshipData

Opcional. Todas las ubicaciones y cadenas relacionadas con esta.

more_hours[]

MoreHours

Opcional. Más horarios para los diferentes departamentos o clientes específicos de una empresa.

service_items[]

ServiceItem

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.

Metadata

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

Campos
has_google_updated

bool

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.

has_pending_edits

bool

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

can_delete

bool

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

can_operate_local_post

bool

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

can_modify_service_list

bool

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

can_have_food_menus

bool

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

can_operate_health_data

bool

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

can_operate_lodging_data

bool

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

place_id

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.

duplicate_location

string

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

maps_uri

string

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

new_review_uri

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.

can_have_business_calls

bool

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

has_voice_of_merchant

bool

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.

MoreHours

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

Campos
hours_type_id

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.

periods[]

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.

MoreHoursType

Más tipos de horarios que una empresa puede ofrecer, además de sus horarios habituales.

Campos
hours_type_id

string

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

display_name

string

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

localized_display_name

string

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

OpenInfo

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

Campos
status

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.

can_reopen

bool

Solo salida. Indica si este negocio es apto para su reapertura.

opening_date

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.

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.

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

Campos
primary_phone

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.

additional_phones[]

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

PlaceInfo

Define un área representada por un ID de lugar.

Campos
place_name

string

Obligatorio. El nombre localizado del lugar. Por ejemplo, Scottsdale, AZ.

place_id

string

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

Places

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

Campos
place_infos[]

PlaceInfo

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

Perfil

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

Campos
description

string

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.

Campos
parent_location

RelevantLocation

La ubicación principal con la que tiene relaciones esta ubicación.

children_locations[]

RelevantLocation

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

parent_chain

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]

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.

Campos
place_id

string

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

relation_type

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

RepeatedEnumAttributeValue

Valores para un atributo con un value_type de REPEATED_ENUM. Esto consiste en dos listas de ID de valores: las que están configuradas (verdadero) y las que no están establecidas (falso). Los valores ausentes se consideran desconocidos. Se debe especificar al menos un valor.

Campos
set_values[]

string

Enum. Los valores establecidos.

unset_values[]

string

Valores de enumeración que no están establecidos.

SearchChainsRequest

Mensaje de solicitud para locations.SearchChains.

Campos
chain_name

string

Obligatorio. Busca una cadena por su nombre. Se admiten consultas exactas, parciales, parciales o relacionadas. Ejemplos: "walmart", "wal-mart", "walmmmart", "沃尔玛"

page_size

int32

La cantidad máxima de cadenas coincidentes que se mostrarán con esta consulta. El valor predeterminado es 10. El valor máximo posible es 500.

SearchChainsResponse

Mensaje de respuesta para locations.SearchChains.

Campos
chains[]

Chain

Cadenas que coinciden con el string_display_name consultado en SearchChainsRequest. Si no hay coincidencias, este campo estará vacío. Los resultados se muestran en orden de relevancia.

SearchGoogleLocationsRequest

Mensaje de solicitud para GoogleLocations.SearchGoogleLocations.

Campos
page_size

int32

La cantidad de coincidencias que se mostrarán. El valor predeterminado es 3, con un máximo de 10. Ten en cuenta que la latencia puede aumentar si se solicitan más. No hay paginación.

Campo de unión search_query. Búsqueda. Se puede proporcionar como un objeto de ubicación o como una consulta de cadena. Las direcciones (search_query) solo pueden ser una de las siguientes opciones:
location

Location

Ubicación para buscar. Si se proporciona, encontrará ubicaciones que coinciden con los detalles de ubicación proporcionados.

query

string

Consulta de texto para buscar. Los resultados de la búsqueda provenientes de una cadena de consulta serán menos precisos que proporcionar una ubicación exacta, pero pueden proporcionar coincidencias más inexactas.

SearchGoogleLocationsResponse

Mensaje de respuesta para GoogleLocations.SearchGoogleLocations.

Campos
google_locations[]

GoogleLocation

Es un conjunto de GoogleLocations que son posibles coincidencias con la solicitud especificada, ordenados de mayor a menor exactitud.

ServiceAreaBusiness

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

Campos
business_type

BusinessType

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

places

Places

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

region_code

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.

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 storefront_address y establecer el campo como vacío.
CUSTOMER_AND_BUSINESS_LOCATION Ofrece servicio en la dirección de la empresa y en los alrededores.

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.

Campos
price

Money

Opcional. Representa el precio monetario del artículo de servicio. Recomendamos que se establezcan currency_code 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:
structured_service_item

StructuredServiceItem

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

free_form_service_item

FreeFormServiceItem

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

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.

Campos
category

string

Obligatorio. Este campo representa el nombre de la categoría (es decir, el ID estable de la categoría). category y service_type_id deben coincidir con las combinaciones posibles que se proporcionan en el mensaje Category.

label

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

StructuredServiceItem

Representa un servicio estructurado que ofrece el comercio. P. ej., instalación_de_inodoro.

Campos
service_type_id

string

Obligatorio. El campo service_type_id es un ID único proporcionado por Google que se puede encontrar en ServiceType. El servicio de rpc de BatchGetCategories proporciona esta información.

description

string

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

ServiceType

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

Campos
service_type_id

string

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

display_name

string

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

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. open_time y start_date deben ser anteriores a close_time y end_date. close_time y end_date pueden extenderse hasta las 11:59 a.m. del día después de la start_date especificada. Por ejemplo, las siguientes entradas son válidas:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

Las siguientes entradas no son válidas:

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Campos
start_date

Date

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

open_time

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.

end_date

Date

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

close_time

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.

closed

bool

Opcional. Si es verdadero, se ignoran end_date, open_time y close_time, y la fecha especificada en start_date se considera la ubicación cerrada durante todo el día.

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.

Campos
special_hour_periods[]

SpecialHourPeriod

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

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.

Campos
open_day

DayOfWeek

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

open_time

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.

close_day

DayOfWeek

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

close_time

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.

UpdateAttributesRequest

Solicitud para AttributesService.UpdateAttributes.

Campos
attributes

Attributes

Una colección de atributos que deben actualizarse.

attribute_mask

FieldMask

Obligatorio. Es el nombre del atributo que deseas actualizar. Representado por attributes/{attribute}.

Actualizaciones: Todos los atributos proporcionados en el campo de atributos que deseas actualizar se deben configurar en attribute_mask. Se ignorarán los atributos establecidos en la lista anterior, pero no en attribute_mask.

Eliminaciones: Si deseas borrar determinados atributos, deben especificarse en el attribute_mask sin ninguna entrada que coincida en la lista de atributos. Si deseas borrar todos los atributos configurados en una ubicación, debes buscar todos los atributos aplicables para esa ubicación y, luego, agregarlos a attribute_mask con un campo de atributos vacío.

UpdateLocationRequest

Mensaje de solicitud para locations.UpdateLocation.

Campos
location

Location

Obligatorio. La información de ubicación actualizada.

update_mask

FieldMask

Obligatorio. Los campos específicos que se actualizarán.

validate_only

bool

Opcional. Si es verdadero, la solicitud se valida sin actualizar la ubicación. Cuando se configura este campo, solo se mostrarán errores de validación si los hubo. La respuesta estará vacía si no se encontraron errores.

UriAttributeValue

Valores para un atributo con un value_type de URL.

Campos
uri

string

Obligatorio. El valor de URI propuesto para este atributo.