Package google.maps.booking.v1alpha

string

La URL del punto de entrada para este vínculo de acción.

string

La etiqueta de idioma BCP-47 que identifica el idioma en el que está disponible el contenido de este URI.

string

Código de país ISO 3166-1 alpha-2. Déjalo vacío para obtener una visibilidad sin restricciones.

ActionPlatform

La plataforma en la que se debe realizar esta acción. Si no se configura este campo, ACTION_PLATFORM_WEB_APPLICATION se usará como resguardo.

ActionLinkType

Tipo de acción predeterminado

OrderOnlineMetadata

Metadatos del vínculo para pedir en línea. Admite acciones con ActionLinkType de ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Metadatos de los vínculos de Food Ordering Admite el tipo de acción: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT NO admite ACTION_LINK_TYPE_ORDER_FOOD.

EventMetadata

Información adicional sobre el vínculo de acción que es exclusivo de la vertical de eventos.

Surface

Es la plataforma de eventos predeterminada asociada con un vínculo de acción. Solo se usa para la vertical de eventos.

string

Identificador. Es el nombre del recurso de AdsAccountLink. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Obligatorio. Es la lista de los IDs de los elementos del inventario que se vincularán con la cuenta de Google Ads.

State

Solo salida. Estado de la vinculación de la cuenta de Google Ads.

Text

Es el mensaje personalizado que se mostrará al usuario cuando realice una reserva a través de Reserva con Google.

Timestamp

Hora de inicio del espacio disponible.

Duration

Es la duración del espacio disponible.

int64

Es la cantidad de cupos totales y disponibles en este horario disponible. Ejemplos:

• Una clase de yoga con 10 cupos y 3 reservados: availability {spots_total: 10, spots_open: 7 ...}
• Una sesión de masajes en silla que ya está reservada: availability {spots_total: 1, spots_open: 0 ...}

Nota: Si envías solicitudes con el formato de compresión de disponibilidad que se define a continuación, se inferirán estos dos campos.

• El uso de Recurrence implica spots_total=1 y spots_open=1.
• El uso de ScheduleException implica spots_total=1 y spots_open=0.

int64

La cantidad de cupos disponibles

string

Es una string opaca opcional para identificar este espacio disponible. Si se configura, se incluirá en las solicitudes de reservar, actualizar o cancelar citas.

Resources

Son los recursos opcionales que se utilizan para distinguir este espacio disponible de otros cuando hay diferentes miembros del personal o salas como parte del mismo servicio.

P. ej., la misma clase de yoga con 2 instructores:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

Es una lista de ID que hacen referencia a las opciones de pago que se pueden utilizar para adquirir este espacio disponible. Las opciones de pago reales se definen a nivel del comercio y también se pueden compartir entre varios.

Este campo anula cualquier valor de payment_option_ids especificado en el mensaje del servicio. De manera similar, los valores de payment_option_ids especificados aquí NO tienen que estar presentes en el mensaje del servicio, aunque deben definirse a nivel del comercio.

Recurrence

Indica la información de recurrencia para la disponibilidad, que representa más de una hora de inicio. Una recurrencia debe contener citas para un día hábil.

ScheduleException

Son los horarios en los que no se puede programar este servicio. Para limitar la cantidad de mensajes de schedule_exception, considera unir las excepciones adyacentes.

Deposit

Es un depósito opcional para este horario disponible. Anula el depósito de servicio si se especificó uno.

NoShowFee

Indica la tarifa opcional por no presentarse para este espacio disponible. Anula la tarifa por no presentarse del servicio si se especificó una.

Prepayment

Opcional. Información de prepago opcional para este espacio disponible.

RequireCreditCard

Indica si el usuario debe proporcionar una tarjeta de crédito para reservar este espacio disponible. Si no estableces este valor, se heredará del nivel del servicio si lo especificaste allí. (Opcional).

string

Indica una lista de los tipos de entradas admitidos para este espacio disponible. Si no se establece, todos los tipos de entradas del servicio de jerarquía superior estarán disponibles para este espacio. Ten en cuenta que los valores de este campo deben definirse en ese servicio superior. Ejemplos:

• Servicio con cuatro tipos de entrada: TicketType {ticket_type_id: "adult_1" short_description: "Para adultos de lunes a viernes"} TicketType {ticket_type_id: "adult_2" short_description: "Para adultos los fines de semana"} TicketType {ticket_type_id: "youth_1" short_description: "Para jóvenes de lunes a viernes"} TicketType {ticket_type_id: "youth_2" short_description: "Para jóvenes los fines de semana"}

Para representar el inventario de lunes a viernes, utiliza lo siguiente: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Para representar el inventario de los fines de semana, utiliza lo siguiente: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• Servicio con tres tipos de entrada: TicketType {ticket_type_id: "adult" short_description: "Adultos"} TicketType {ticket_type_id: "youth" short_description: "Jóvenes"} TicketType {ticket_type_id: "senior" short_description: "Adultos mayores"}

A fin de indicar que los tres tipos de entrada están disponibles para este horario, utiliza availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} o `availability {...}' (no establezcas el campo ticket_type_id para este horario disponible).

(opcional)

DurationRequirement

El requisito para mostrar la duración de los horarios disponibles o la hora de finalización. Se ignorará este campo si el horario disponible no está disponible. No se usa en la vertical Cosas que hacer. (opcional)

SchedulingRuleOverrides

Se trata de las reglas de programación de la disponibilidad. Si se propagan los campos, anularán cualquier regla de programación correspondiente en las SchedulingRules a nivel del servicio.

ConfirmationMode

Indica el modo de confirmación que se usará cuando se reserve este espacio disponible. Los intentos de crear reservas de horarios disponibles con el modo de confirmación CONFIRMATION_MODE_SYNCHRONOUS se deben aceptar o rechazar de inmediato. Los intentos de crear reservas de horarios disponibles con el modo de confirmación CONFIRMATION_MODE_ASYNCHRONOUS se deben rechazar de inmediato o crear con el estado PENDING.

LinkoutRequiredReason

Opcional. El motivo por el que se requiere un vínculo para este espacio. Si se establece, el recurso del comercio para este espacio debe tener una LinkoutTemplate válida. (opcional)

Timestamp

Es la marca de tiempo UTC máxima inclusiva hasta la cual se repite la disponibilidad.

Duration

Define el tiempo que se debe dejar entre horarios disponibles sucesivos.

Ejemplo: Un horario disponible con el campo duration establecido en 20 min, repeat_every en 30 min, start_time en 9:00 a.m. y repeat_until en 11:00 a.m. generará los siguientes horarios disponibles: de 9 a 9:20 a.m., de 9:30 a 9:50 a.m., de 10 a 10:20 a.m., de 10:30 a 10:50 a.m. y de 11 a 11:20 a.m. (Obligatorio)

TimeRange

Es el período que dura la excepción. Los horarios disponibles descritos en la recurrencia que se superpongan con este período desde el cierre hasta la apertura se considerarán no disponibles.

Ejemplo: Si el parámetro Recurrence tuviera el campo duration establecido en 20 min, repeat_every en 30 min, start_time en 9:00 a.m. y repeat_until en 11:00 a.m. y utilizaras un parámetro ScheduleException con el campo time_range configurado con el período de 9:45 a.m. a 11:00 a.m., los siguientes horarios se marcarían como no disponibles: de 9:30 a 9:50 a.m., de 10 a 10:20 a.m. y de 10:30 a 10:50 a.m.

Ten presente que, como el período abarca desde el cierre hasta la apertura, el horario disponible que comienza a las 11 a.m. no se verá afectado.

int64

Es el último momento (en segundos) en el que se puede reservar este horario disponible. Esta marca de tiempo debe ser anterior al valor en start_sec del horario disponible (si se permite que los usuarios hagan reservas después de la hora de inicio, utiliza SchedulingRules.min_booking_before_end_time a nivel del servicio). Si está presente, anulará cualquier especificación en el campo min_booking_buffer del parámetro SchedulingRules del servicio correspondiente.

int64

Es el primer momento (en segundos) en el que se puede reservar este horario disponible. Esta marca de tiempo debe ser anterior al valor en start_sec del horario disponible o en last_bookable_sec si se especifica.

int64

Si se establece, es la última hora (en segundos desde el ciclo de entrenamiento de Unix) en la que se puede cancelar este horario disponible específico a través de Reservar con Google. Este campo anulará cualquier regla de cancelación a nivel del servicio. (opcional)

string

Es el nombre del recurso, que tiene el formato - partners/{partner_id}/feeds/{feed_name}.

GenericDeleteRecord

Registros que se borrarán. Se permite un máximo de 1,000 registros en una llamada a la API.

string

El nombre del recurso, que tiene el formato - partners/{partner_id}/feeds/{feed_name}.

GenericRecord

Registros que se insertarán o actualizarán. Se permite un máximo de 1,000 registros en una llamada a la API.

string

Formato de partners/{partner_id}.

ExtendedServiceAvailability

La disponibilidad extendida del servicio que se usa para reemplazar los horarios disponibles existentes.

ExtendedServiceAvailability

Los mensajes de disponibilidad extendida del servicio se actualizaron correctamente y se usaron para reemplazar los horarios disponibles existentes.

string

Nombre del recurso de la reserva: partners/{partner ID}/bookings/{booking ID}

string

ID del comercio para el horario disponible

string

ID del servicio del comercio

Timestamp

Es la hora de inicio del horario disponible.

Duration

Es la duración del espacio disponible.

ClientInformation

Información personal del cliente que programa la cita

BookingStatus

Estado de la reserva

PaymentInformation

Es la información sobre las transacciones de pago relacionadas con la reserva.

int64

Es el tamaño del grupo para el que se hace la reserva.

Cause

Es el motivo por el que se produjo un error en la reserva. (Obligatorio)

CreditCardType

(obligatorio solo si la causa es PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

Este campo opcional se utiliza para que el socio incluya información adicional solo con fines de depuración. (Opcional)

PaymentFailureInformation

Es la información sobre los errores de pago.

ThreeDS1Parameters

Son los parámetros que utiliza un agregador RwG para iniciar un protocolo de autenticación 3DS1 con el usuario. Se ignorará, a menos que BookingFailure.cause se establezca en PAYMENT_REQUIRES_3DS1.

string

La URL desde la cual se carga un formulario para presentárselo al usuario de autenticación

string

Es una solicitud de PaymentAuthentication. Se publicará en el formulario ACSUrl si está incluido.

string

Es un identificador que utiliza el proveedor de ACS. Se publicará en el formulario ACSUrl si está incluido.

string

Datos del comercio. Se publicará en el formulario ACSUrl si está incluido.

RefundCondition

Hay cero o más condiciones de reembolso aplicables a la política.

Duration

Es la duración antes de la hora de inicio que indica hasta cuándo el cliente puede recibir un reembolso parcial del costo del servicio especificado en refund_percent. Cuando se establece en 0 (valor predeterminado), el servicio se puede cancelar en cualquier momento.

uint32

Es el porcentaje que se puede reembolsar en un rango de [0, 100], siempre que la reserva del servicio se cancele antes de la hora de inicio del servicio, según se establezca en min_duration_before_start_time. Cuando se establece en 0 (valor predeterminado), el servicio no es reembolsable. Cuando se establece en 100, el servicio es completamente reembolsable.

string

Es el nombre del cliente.

string

Apellido del cliente

PostalAddress

Dirección del cliente

string

Número de teléfono del cliente

string

Dirección de correo electrónico del cliente

string

Obligatorio. Es el recurso superior en el que se creará este vínculo de cuenta de Google Ads. Es el mismo que el ID de la cuenta del Centro de socios. Formato: partners/{partner}

string

Obligatorio. Es el ID que se utilizará para la vinculación de la cuenta de Google Ads. Coincide con el ID de cliente de Google Ads. Para obtener más detalles, consulte https://support.google.com/google-ads/answer/1704344 Formato : xxx-xxx-xxxx.

AdsAccountLink

Obligatorio. El AdsAccountLink que se creará.

string

Es el nombre del recurso superior del socio que posee este comercio, en el formato partners/{partner_id}.

string

Es el ID de comerciante que se usará para este comercio.

Merchant

Es el comercio que se creará.

string

Es el nombre de recurso superior del comercio propietario de este servicio, en el formato partners/{partner_id}/merchants/{merchant_id}.

string

Es el ID de servicio que se debe utilizar para este servicio.

Service

El servicio que se creará.

CreditCardType

Indica una lista de las tarjetas de crédito admitidas. Si este campo está vacío, no se admite ninguna tarjeta de crédito.

string

Obligatorio. Es el nombre del AdsAccountLink que se borrará. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Es el nombre de recurso del comercio que se borrará. Tiene este formato: partners/{partner_id}/merchants/{merchant_id}

string

Es el nombre de recurso del servicio que se borrará. Tiene este formato: partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

Es el importe del depósito.

int64

Es el importe mínimo de cancelación anticipada del depósito.

PriceType

Define cómo se determina el depósito a partir de la disponibilidad.

Text

Se recomienda a los usuarios que paguen solo mediante la forma de pago que se menciona a continuación.

Duration

Duración mínima.

Duration

Duración máxima.

Text

Obligatorio. Nombre, dirección, número de teléfono y dirección de correo electrónico del operador económico, definido como el fabricante, el representante autorizado, el importador, el distribuidor, el proveedor de servicios de cumplimiento o cualquier otra persona física o jurídica sujeta a obligaciones relacionadas con la fabricación de productos, su puesta a disposición o su puesta en servicio Representación de cadena de forma libre del operador_economic. Esta información puede tener el formato " ”. y "\n".

string

Este es un campo obligatorio para especificar a qué comercio pertenecen los mensajes de disponibilidad que aparecen a continuación.

string

Este es un campo obligatorio para especificar a qué servicio pertenecen los mensajes de disponibilidad que aparecen a continuación.

Timestamp

Si se proporciona, consideraremos que las entidades de disponibilidad provistas corresponden a un resumen completo de [start_time_restrict, end_time_restrict]. Es decir, se borrará toda la disponibilidad existente si se cumple la siguiente condición:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Si se establece un mensaje de duración, la condición se verá aún más restringida:

  availability.duration == duration_restrict

Si se establece un mensaje de resources_restrict, la condición se verá aún más restringida:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Estos campos suelen utilizarse para proporcionar una actualización completa de la disponibilidad en un período determinado.

Si se establece start_time_restrict, pero se deja end_time_restrict sin definir, se interpretará que el período en cuestión abarca desde start_time_restrict en adelante.

Timestamp

Si se establece end_time_restrict, pero se deja start_time_restrict sin definir, se interpretará que el período en cuestión abarca todo el período hasta end_time_restrict.

Duration

Si se establece la duración, el alcance de la actualización se verá aún más restringido y solo abarcará la disponibilidad cuya duración coincida con aquella establecida.

Resources

Si se establece resources_restrict, el alcance de la actualización se verá aún más restringido y solo abarcará este conjunto de recursos. Todos los campos de ID de los recursos deben coincidir exactamente.

Availability

Es la nueva lista de horarios disponibles.

int64

Elementos que agregó este feed recientemente. Los artículos pueden ser comerciantes, horarios disponibles o servicios, según el tipo de feed.

int64

Artículos existentes, actualizados según sea necesario a partir de la información más reciente del feed.

int64

Artículos que ya no están presentes en este feed y que se quitaron como resultado.

string

El nombre del recurso del feed, que tiene el formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

Es el estado de procesamiento de este feed.

string

Cadena legible que proporciona más detalles si no pudimos procesar este feed.

FeedStatistics

Son estadísticas específicas de este feed.

FeeDetails

Detalles de las tarifas que se le cobran al usuario además del total del artículo. Se repite para diferentes tipos de tarifas, como cargos del servicio, cargos de entrega, etcétera.

AdvanceOrderDetails

Detalles sobre la compatibilidad con pedidos avanzados, también conocidos como pedidos anticipados, en los que el usuario puede realizar un pedido para que se complete más adelante.

Duration

Duración fija. Por ejemplo: 30 min.

DurationRange

Es un rango de duración. Ejemplos: * De 30 a 45 minutos * Más de 30 minutos * Menos de 50 minutos

bool

Verdadero si se admite la opción Pedidos anticipados, también conocido como Pedido por adelantado. (obligatorio)

FeeType

Tipo de tarifa. (obligatorio)

FeeAmount

Es el importe de la tarifa expresado en la moneda de la unidad, un porcentaje del valor del carrito o una combinación de ambos. (obligatorio)

QuantitativeValue

Es la tarifa en términos de un porcentaje del valor del carrito. Admite un rango (delimitado y no delimitado) o un porcentaje fijo. Debe ser un valor entre 0 y 100. Ejemplos: * 5.5% fijo * Al menos 5.5% * Como máximo, 5.5% * Entre 4.5% y 5.5%

Money

Importe fijo. Por ejemplo, USD 3.5.

MoneyRange

Rango del importe. Ejemplos: * Entre USD 3.5 y USD 5.5 * Al menos USD 3.5 * Como máximo USD 5.5

bool

Importe desconocido.

FulfillmentType

Obligatorio. El tipo de entrega.

AvailableDay

Obligatorio. Una lista de los días en los que hay disponibilidad para este método de entrega (preferentemente, al menos 2)

FeeDetails

Obligatorio. Son los detalles de la tarifa del método de entrega.

Price

Obligatorio. Es el pedido mínimo para el método de entrega asociado con el vínculo de acción.

Date

Obligatorio. Es una fecha disponible para un método de entrega. Se supone que está en la zona horaria del comercio.

Timestamp

Obligatorio. Marca de tiempo de Unix. La última vez que un usuario pudo hacer un pedido y recibir artículos antes del fulfillment_date. En otras palabras, después de last_ordering_time, fulfillment_date ya no se mostrará como disponible.

Por ejemplo, si la fecha de entrega es 10/08/2020, un valor de last_ordering_time de 10/08/2020 18:00 significa que, para recibir su pedido el 10/08/2020, un cliente debe realizarlo antes de las 6 p.m. ese mismo día. - un valor last_ordering_time de 2020-08-08 20:00 significa que, para recibir su pedido el 10-08-2020, el cliente debe hacer el pedido a las 8 p.m. dos días antes.

NoFee

No se cobra ninguna tarifa por el método de entrega.

MinimumFee

Es la tarifa base asociada con el método de entrega.

FixedFee

Es la tarifa fija asociada con el método de entrega.

Price

Obligatorio. El importe de la tarifa fija del método de entrega.

Price

Obligatorio. El importe de la tarifa base del método de entrega.

Timestamp

Obligatorio. Esta marca de tiempo se usa para determinar el orden en el que se aplicará una eliminación al inventario.

bytes

Para feeds que no se basan en protos.

Any

Para feeds basados en proto.

Timestamp

Obligatorio. Esta marca de tiempo se usa para garantizar el orden correcto de las actualizaciones del inventario.

bytes

Para feeds que no se basan en protos.

Any

Para feeds basados en prototipos.

double

Es la latitud en grados. (Opcional)

double

Es la longitud en grados. (Opcional)

PostalAddress

Dirección postal de la ubicación (preferida).

string

También se puede proporcionar una dirección no estructurada como resguardo, p. ej., "1600 amphitheatre parkway mountain view, ca 94043".

string

Obligatorio. Es el nombre del vínculo de la cuenta de Google Ads que se recuperará. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Obligatorio. Es el nombre del recurso, con el formato partners/{partner_id}/merchants/{merchant_id}/status.

string

El nombre del recurso del feed, que tiene el formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

La categoría de alto nivel a la que pertenece este servicio para el hogar. P.ej., plomero, electricista, etc.

string

Es el tipo de trabajo de la categoría a la que pertenece el servicio de la casa. p. ej., unclog_drain, install_faucet son los tipos de trabajo en la categoría de plomero.

string

Es el nombre del recurso que se invalidará.

Por ejemplo, para un recurso de punto de partida, el nombre debe tener el formato partners/{partner_id}/pickups/{pickup_id}. Las implementaciones DEBEN eliminar las versiones almacenadas en caché del recurso identificado.

string

Es el ID del servicio del comercio.

int64

Hora de inicio del horario disponible en segundos de la hora UTC desde el epoch Unix.

int64

Es la duración del horario disponible en segundos.

OrderedTickets

Cantidad de entradas ordenadas por tipo de entrada.

Price

Es el precio total (sin impuestos) de esta línea de pedido.

BookingStatus

Estado de la línea de pedido.

string

ID de un tipo de ticket.

int32

Cantidad de entradas pedidas para este tipo.

string

Obligatorio. El elemento superior, que es propietario de esta colección de estados de comercios. Formato: partners/{partner_id}/merchants

int32

Obligatorio. La cantidad máxima de elementos que se mostrarán. Ten en cuenta que el servidor puede reducir el tamaño de la página.

string

Opcional. El valor de nextPageToken que se muestra de una ListMerchantStatusResponse anterior, si existe.

BookingInventoryStatus

Opcional. Restricción opcional para filtrar los resultados por estado del inventario de reservas.

WaitlistInventoryStatus

Opcional. Restricción opcional para filtrar los resultados por estado del inventario de la lista de espera.

GeoMatchingStatus

Opcional. Restricción opcional para filtrar los resultados por estado de coincidencia geográfica

MerchantStatus

Es la lista de estados de los comercios que cumplen con las condiciones del filtro.

string

Es el token para recuperar la página siguiente de resultados. Si está vacío, esto significa que no hay más resultados en la lista.

string

Es el nombre de recurso del feed, en el siguiente formato:

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

La cantidad máxima de elementos que se mostrarán.

string

El valor next_page_token que se muestra de una solicitud de lista anterior, si existe.

State

Restringir opcional para filtrar los resultados por estado del feed

TimeRange

Es una restricción opcional para filtrar los resultados por límite inferior y superior. Si no se establece el campo start_time, la configuración predeterminada será el inicio del tiempo Unix. Si no se establece el campo end_time, la configuración predeterminada será la hora actual.

FeedStatus

Es la lista en orden cronológico inverso de los estados de los feeds subidos. La cantidad máxima de elementos mostrados se basa en el campo page_size de la solicitud.

string

Es el token para recuperar la página siguiente de resultados. Si está vacío, esto significa que no hay más resultados en la lista.

string

Es un código de idioma IETF BCP 47, como "en", "mas", "zh-Hant", "de-CH-1901", etc. Consulta http://www.w3.org/International/articles/language-tags/.

string

Es el mensaje en la configuración regional anterior (UTF-8).

string

Es el ID de un lugar en la base de datos de Google Places y en Google Maps. Consulta https://developers.google.com/places/web-service/place-id para obtener más información sobre los IDs de lugar. Si se proporciona, Google correlacionará la ubicación con este lugar.

string

El nombre, el teléfono, la URL y la información geográfica de la ubicación permiten correlacionar la ubicación con lugares que ya se incluyen en Google Maps.

Este campo es opcional, pero puede ser obligatorio en algunos contextos. Por ejemplo, Service.location sin un nombre no se hará coincidir con una entidad comercial, incluso si se encuentran en la misma dirección. (opcional)

string

Es el número de teléfono público de la ubicación, incluidos los códigos de país y de área, p. ej., +14567891234. (Opcional)

string

Es la URL del sitio web público de la ubicación. (Opcional)

GeoCoordinates

Es la información geográfica de la ubicación, incluidas la latitud, la longitud y la dirección. (Opcional)

LocationType

Es el tipo de ubicación. Se debe proporcionar si esta ubicación se proporciona para un servicio.

string

Es una referencia exclusiva de la ubicación dentro del servicio. El ID se puede utilizar para hacer referencia a esta ubicación en otros campos del servicio. Por ejemplo, en el formulario de admisión personalizado, se puede utilizar un conjunto de IDs de ubicación para especificar opciones de puntos de retiro. Si se establece, este ID debe ser único dentro de un mismo servicio. (Opcional)

string

Es el nombre del recurso del comercio, en el formato partners/{partner_id}/merchants/{merchant_id}.

string

El campo merchant_name, el teléfono, la URL y la información geográfica permiten correlacionar el inventario del socio con comercios que ya se incluyen en Google Maps. Esta información no se mostrará.

Es el nombre del comercio.

string

Es el número de teléfono público del comercio, incluidos los códigos de país y área, p. ej., +14567891234.

string

Es la URL del sitio web público del comercio.

GeoCoordinates

Es la información geográfica del comercio, incluidas la latitud, la longitud y la dirección.

string

Es la categoría de la empresa en la plataforma del agregador.

int64

Este campo es obsoleto.

uint32

Es la tasa impositiva del comercio en puntos básicos (la centésima parte de un punto porcentual). Por ejemplo, si la tasa impositiva es del 7.5%, este campo se debe establecer en 750.

Si este campo no se define o se establece en 0, el precio total que se cobra a un usuario por cualquier servicio provisto por este comercio es el precio exacto especificado en Service.price. Se supone que el precio del servicio está exento de impuestos o que ya incluye los impuestos aplicables. Los impuestos no se mostrarán al usuario como una línea de pedido separada.

Si este campo se establece en un valor distinto de cero, el precio total que se le cobrará a un usuario por cualquier servicio provisto por este comercio incluirá el precio del servicio más el impuesto calculado con la tasa impositiva proporcionada aquí. Las fracciones de la unidad monetaria más pequeña (por ejemplo, fracciones de un centavo) se redondearán al número entero más cercano. Los impuestos se mostrarán al usuario como un elemento de una sola línea aparte.

Este campo es obsoleto; utiliza tax_rate en su lugar.

TaxRate

Es la tasa impositiva del comercio. Si está presente, este campo anula el campo obsoleto tax_rate_basis_points. Un mensaje vacío (es decir, tax_rate { }) restablecerá la tasa impositiva a cero.

PaymentRestrictions

Son las restricciones relacionadas con las formas de pago que acepta este comercio. Suponemos que no existen restricciones si no se establece este campo.

PaymentOption

Son las opciones de pago disponibles para este comercio. Los servicios de este comercio podrán limitar individualmente las opciones de pago que permiten.

PaymentProcessorConfig

Es la configuración de un procesador de pagos con tokens, si el comercio lo admite.

TokenizationConfig

Es la configuración de un procesador de pagos con tokens, si el comercio lo admite.

Terms

Son los Términos y Condiciones específicos del comercio que se muestran al usuario cuando se reserva un servicio a través de Reserva con Google. Además, los Términos y Condiciones del socio agregador siempre se muestran al usuario y no se deben proporcionar aquí.

string

Es una string opaca que identifica la marca orientada al consumidor que se debe utilizar al mostrar la atribución del socio. Este campo permite que los socios con varias marcas orientadas al consumidor proporcionen comercios para todas las marcas dentro del mismo feed.

Una marca consiste en propiedades orientadas al consumidor, como el nombre, el logotipo, las Condiciones del Servicio y la Política de Privacidad.

Si solo hay una marca de socio orientada al consumidor, este campo se puede omitir.

Posibles situaciones:

El socio no tiene varias marcas orientadas al consumidor: Omite este campo.

El socio tiene varias marcas configuradas:

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Nota importante: La mayoría de los socios no necesitan establecer este campo. Si un socio desea utilizar este campo, primero debe comunicarse con nosotros para configurar marcas separadas, incluida la marca predeterminada.

MerchantMatchingHints

Son las sugerencias para ayudar a Google a correlacionar un comercio con un lugar en Google Maps. Nota: La mayoría de los socios no necesitan configurar este campo, ya que Google utilizará la información proporcionada anteriormente para establecer una coincidencia entre los comercios y los lugares de Google Maps. (Opcional).

ServiceAttribute

Son las definiciones de cualquier atributo de servicio utilizado para describir los servicios de este comercio. (opcional)

ActionLink

Opcional. Una URL de acción con un idioma asociado, una lista de países restringidos, un tipo y una plataforma opcional que indique en qué plataforma se debe realizar esta acción.

Advisement

Opcional. Son avisos generales de un comercio específico para un usuario que se une a una lista de espera a través de Reserva con Google. En el asesoramiento, los campos de texto individuales deben limitarse a 100 bytes de longitud.

EconomicOperator

Opcional. Información del operador económico asociada a este comercio específico necesaria para el cumplimiento normativo (opcional)

string

Es el ID de un lugar en la base de datos de Google Places y en Google Maps. Consulta https://developers.google.com/places/web-service/place-id para obtener más información sobre los IDs de lugar.

string

El nombre del recurso de estado del comercio, que tiene el formato partners/{partner_id}/merchants/{merchant_id}/status

string

Es el nombre del comercio proporcionado por los socios.

GeoCoordinates

Los socios proporcionaron información geográfica del comercio.

ProcessingStatus

Estado de procesamiento del comercio

BookingStatus

Estado relacionado con la integración de reservas de extremo a extremo.

WaitlistStatus

Es el estado relacionado con la integración de la lista de espera.

PlaceInfo

Es el lugar geográfico coincidente de este comercio. Está vacío si el comercio no tiene coincidencia geográfica.

LocalServicesMatchInfo

Coincidencia de Servicios Locales de este comercio Debe estar vacío si no es un comercio de servicios locales o no coincide con ningún proveedor.

DirectUrl

Una lista de URLs para demostrar el contenido del inventario actual del comercio. Ten en cuenta que esto no significa que el inventario se esté publicando y que la URL puede ser diferente de las que son visibles para el público.

bool

Verdadero si el comercio tiene inventario durante los próximos 30 días. No garantiza que el comercio se publique.

UrlType

Es el tipo de esta URL.

string

URL en la que puede aparecer este comercio.

MatchedProvider

Proveedores de servicios coincidentes. Un comercio puede asociarse con varios proveedores de servicios.

int64

ID de cliente externo de Servicios Locales de Google.

string

Categorías de servicios locales (verticales). P.ej., "plomero" y "carpet_cleaning".

string

Es el nombre del lugar.

string

Dirección con formato en el idioma local.

string

Es el ID de Google Place de este lugar. Se puede utilizar para construir una URL de Google Maps o para recuperar más detalles del lugar. Consulta https://developers.google.com/places/web-service/place-id para obtener un ejemplo de uso.

bool

Es verdadero si el comercio tiene un servicio de lista de espera. No garantiza que el comercio realmente se publique.

Money

Importe mínimo.

Money

Importe máximo

Price

Es el importe que se puede cobrar al usuario si no se presenta a su reserva.

PriceType

Define cómo se determina la tarifa a partir de la disponibilidad.

string

Nombre del recurso del pedido: partners/{partner ID}/orders/{order ID}

ClientInformation

Es la información personal del cliente que realiza el pedido.

PaymentInformation

Es la información sobre las transacciones de pago relacionadas con el pedido.

string

Es el ID del comercio al que pertenecen todos los servicios de este pedido.

LineItem

Son las líneas de pedido de este pedido.

FulfillmentOption

Opciones de entrega disponibles para un vínculo de acción de pedido en línea.

PrepaymentStatus

Es el estado del prepago de la reserva. Si el campo prepayment_status se establece en PREPAYMENT_PROVIDED o PREPAYMENT_REFUNDED, el campo payment_transaction_id contendrá el ID de transacción único asociado.

string

Es el identificador único de una transacción de pago asociada con la reserva. Este campo estará vacío si no es aplicable.

string

Este ID se utiliza para identificar esta opción de pago.

Este ID es global, por lo que se aplica a todo el agregador. Esto implica que, si se reutiliza en varios comercios, un mismo usuario podrá pagar con la opción de pago correspondiente en todos esos comercios.

Cuando se reutiliza un ID en varios comercios y se actualiza cualquier valor de una opción de pago en uno de ellos, también se actualizarán todas las demás opciones de pago con el mismo ID en los otros comercios. Por lo tanto, se recomienda que todas las opciones de pago que compartan el mismo ID siempre se actualicen a valores idénticos para evitar cualquier posibilidad de comportamientos no esperados.

string

Es el nombre de la opción de pago. Puede ser visible para el usuario.

string

Es una descripción de la opción de pago. Puede ser visible para el usuario.

Price

Es el precio de la opción de pago.

TaxRate

Es la tasa impositiva de esta opción de pago. Si está presente, este campo anula cualquier valor de tax_rate especificado en el comercio o servicio. Un mensaje vacío (es decir, tax_rate { }) restablecerá la tasa impositiva a cero.

PaymentOptionType

Es el tipo de esta opción de pago. Uso único para las compras ocasionales, usos múltiples para los paquetes y uso ilimitado para las membresías.

int64

Indica la cantidad de sesiones para las que se puede usar esta opción de pago. Válido solo para sesiones múltiples y paquetes, donde el valor debe ser superior a 1.

TimeRange

La opción de pago se puede comprar dentro de este intervalo.

TimeRange

La opción de pago se puede utilizar dentro de este intervalo (p. ej., un precio especial durante enero de 2017). Si está presente, este campo anula cualquier valor en valid_duration y activation_type.

Duration

Es la duración de la validez de la opción de pago (p. ej., una membresía de 30 días).

ActivationType

Define cómo se determina la fecha de inicio de la validez de esta opción de pago.

UserPurchaseRestriction

Restringe los usuarios aptos para hacer compras utilizando esta opción de pago. Se puede usar para restringir una opción de pago promocional a un subconjunto de usuarios. Si no se establece, todos los usuarios serán aptos.

Processor

Define el socio del procesador de pagos al que se aplica esta configuración.

string

Es la clave utilizada para identificar a este comercio con el procesador de pagos.

Para obtener información sobre Stripe, consulta https://stripe.com/docs/dashboard#api-keys. Para obtener información sobre Braintree, consulta https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

Es el número de versión de la API que se envía al procesador de pagos junto con las solicitudes de pago.

CreditCardRestrictions

Son las restricciones relacionadas con las tarjetas de crédito que acepta este comercio. Asumimos que se aceptan todas las tarjetas de crédito si no se establece este campo. Ten presente que la lista de tarjetas admitidas para CreditCardType aumentará con el transcurso del tiempo, lo que significa que, si dejas este campo vacío, la configuración quedará sujeta a cambios futuros.

Price

Es una tarifa que puede variar según el método de entrega.

Price

Es una tarifa para procesar la forma de pago del usuario.

Price

Es un cargo adicional que se cobra por el servicio.

Price

Es una tarifa que se destina al lugar o la instalación.

Price

Son los impuestos por entrada.

string

El país, especificado con el código de país ISO 3166-1 alpha-2, p.ej., “US” (obligatorio)

string

La localidad, p.Ej., "Mountain View". (obligatoria)

string

La región, p.Ej., "CA". Este campo solo es obligatorio en los países donde la región suele formar parte de la dirección. (opcional)

string

El código postal, p.Ej., "94043". (obligatoria)

string

La dirección, p.Ej., "1600 Amphitheatre Pk acuerdo". (obligatorio)

PriceInfo

Recipiente para los detalles de los precios.

int64

Es el precio en microunidades de la moneda. Las fracciones de la unidad de moneda más pequeña se redondearán al número entero par más cercano. Por ejemplo, los siguientes valores se redondearán de la siguiente manera: 2.5 centavos a 2 centavos, 3.5 centavos a 4 centavos, 0.5 centavos a 0 centavos y 2.51 centavos a 3 centavos.

string

Es la moneda del precio que se define en la norma ISO 4217.

string

Es una cadena opcional y opaca que identifica la opción de precio asociada con el precio extendido.

PriceType

Define cómo se aplica el precio o el intervalo de precios (por persona o fijo).

Price

Es el precio de un servicio o una tarifa.

PriceRange

Es el límite superior o inferior de un servicio o una tarifa.

Price

Importe mínimo.

Price

Importe máximo. Siempre debe ser superior a min_price.

double

Un valor único. Por ejemplo: 5.6

RangeValue

Es un rango de valores que también puede ser abierto o limitado. Ejemplos: * Al menos 5.5 * Como máximo 5.5 * De 5.5 a 6.5

double

Valor mínimo.

double

Valor máximo

double

Es el valor de calificación promedio (obligatorio cuando number_of_ratings es superior a 0). El valor debe estar en el rango de [1, 5] y se puede omitir solo si number_of_ratings es cero.

uint64

Es la cantidad de calificaciones que se utilizan para calcular el valor (obligatorio).

string

Es la URL de esta fuente de contenido multimedia. Google rastreará el contenido multimedia alojado en esta URL.

MediaType

Es el tipo de esta fuente de contenido multimedia.

Text

Es la leyenda del contenido multimedia compatible con i18n. Solo se admite texto sin formato. Se quitarán todos los componentes HTML. (Opcional)

Attribution

Es la información de atribución sobre la fuente del contenido multimedia. Ten presente que este campo se debe establecer si es obligatorio mostrar la atribución con el contenido multimedia para dar crédito a un fotógrafo o una agencia. (Opcional)

string

Este campo es obsoleto, por lo que es preferible que utilices localized_caption.

Text

Es el texto para dar crédito al fotógrafo o a la agencia compatible con i18n. Este texto se mostrará junto con el contenido multimedia de origen. Ten presente que solo se admite texto sin formato para este campo. Se quitarán los componentes HTML (no se admite la atribución basada en hipervínculos).

string

Este campo es obsoleto, por lo que es preferible que utilices localized_text.

ServiceAvailability

Es la disponibilidad del servicio que se utiliza para reemplazar aquella existente.

string

Es el ID opcional para un miembro del personal que proporciona el servicio. Este campo identifica a este miembro en todos los comercios, servicios y registros de disponibilidad. También debe ser estable en el tiempo para permitir la correlación con reservas anteriores. Este campo debe estar presente si se establece el campo staff_name.

string

Es un nombre opcional de un miembro del personal que proporciona el servicio. Este campo se mostrará a los usuarios que realicen una reserva y debe ser legible, en contraposición a lo que sucede con el identificador opaco. Este campo debe estar presente si se establece el campo staff_id.

string

Es un ID opcional para la sala donde se proporcionará el servicio. Este campo identifica la sala en todos los comercios, servicios y registros de disponibilidad. También debe ser estable en el tiempo para permitir la correlación con reservas anteriores. Este campo debe estar presente si se establece el campo room_name.

string

Es un nombre opcional para la sala donde se proporcionará el servicio. Este campo se mostrará a los usuarios que realizan una reserva y debe estar expresado en lenguaje natural. Es decir, no debe ser un identificador opaco. (opcional, pero obligatorio si room_id está presente) En el caso de los restaurantes, el nombre de la sala solo debe usarse para las áreas de asientos, como el bar o el patio, y no para menús con precios fijos, actividades especiales ni ningún otro valor que no sea de la habitación (como reserva o cena). Se recomienda que el área de asientos predeterminada no tenga una habitación asociada.

int32

Este campo solo es aplicable a restaurantes: indica el tamaño de la fiesta que se puede incluir durante este espacio de tiempo disponible. Un restaurante se puede asociar con varios horarios disponibles para la misma hora, cada uno con un tamaño de grupo diferente en party_size si, por ejemplo, la reserva puede acomodar 2, 3 o 4 personas.

Text

Opcional. Descripción de la sala localizada. Si se establece, se debe proporcionar un valor predeterminado. Es preferible proporcionar también idiomas comunes para la configuración regional del comercio. (opcional)

int64

Es el aviso anticipado mínimo en segundos que se requiere para cancelar una cita programada en línea. (Opcional)

Price

Es la tarifa que se cobra por cancelar una reserva dentro del período mínimo de aviso anticipado.

Price

Es la tarifa que se cobra por no presentarse sin cancelar la reserva.

AdmissionPolicy

Es la política de admisión que se aplica a este servicio. Si no se establece, la configuración predeterminada será TIME_STRICT. (Opcional)

CancellationPolicy

Es la política de cancelación de las reglas de programación. (Obligatorio para la vertical Actividades)

int64

Es la duración (en segundos) desde el momento en que se puede realizar la última reserva hasta que comienza el horario disponible.

int64

Es la duración (en segundos) desde el momento en el que se puede realizar la última reserva hasta que finaliza el horario disponible. Si se establece este campo, "admission_policy" se debe configurar en TIME_FLEXIBLE para indicar que los usuarios pueden utilizar las entradas compradas después de que comience el horario disponible.

string

El nombre del recurso del servicio, que tiene el formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

Es el nombre del servicio, p. ej., "Cortes de cabello para hombres". Este campo es obsoleto; utiliza localized_service_name en su lugar.

Text

Es el nombre del servicio, p. ej., "Cortes de cabello para hombres". Posiblemente se proporcione en varias configuraciones regionales.

string

Es la descripción del servicio que se muestra al usuario. Este campo es obsoleto; utiliza localized_description en su lugar.

Text

Es la descripción del servicio que se muestra al usuario.

Este campo admite texto sin formato y similar al de HTML. A diferencia de las secciones de texto sin formato, aquí se pueden crear diseños personalizados con encabezados, párrafos, listas y algunas etiquetas de frase. Lee atentamente las siguientes instrucciones y notas para asegurarte de crear la mejor experiencia del usuario.

Etiquetas de formato admitidas similares a las que se utilizan en HTML:

Etiquetas de encabezado: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Las etiquetas de encabezado se pueden utilizar para mostrar títulos y subtítulos. Por ejemplo, <h1>Itinerario</h1> mostrará el texto intercalado como el encabezado más importante de la sección. Ten presente que se ignorarán todas las etiquetas, los estilos o los atributos HTML internos. Por ejemplo, <h1 style=".."> se tratará de la misma manera que <h1>. Solo se conservará el texto puro.

Etiqueta de párrafo: <p>
La etiqueta de párrafo se puede utilizar para destacar una introducción o contenidos detallados. Se ignorarán todas las etiquetas, los estilos o los atributos internos, con algunas excepciones: <br>, <strong> y <em>. Consulta la sección de etiquetas de frase que se encuentra a continuación para obtener más detalles.

Etiquetas de lista: <ul>, <ol> y <li>
La etiqueta <ul> se puede utilizar con la etiqueta <li> para mostrar listas sin ordenar, y la etiqueta <ol> se puede usar con la etiqueta <li> para mostrar listas ordenadas. Resultan útiles para mostrar listas de tareas, programas o cualquier otra lista que se ajuste a tus casos prácticos.
Ejemplo: Para mostrar una lista de características de un viaje en crucero:
<ol>
<li>Una vista maravillosa al mar y oportunidades para jugar con la vida silvestre.</li>
<li>Servicios y arreglos de viaje cuidadosamente diseñados.</li>
<li>Precio más bajo garantizado.</li>
</ol>
Tenga en cuenta que solo <li> niños menores de <ul> o <ol> las etiquetas se convertirán. Se descartarán todos los demás elementos secundarios. Además, se ignorarán las etiquetas, los atributos y los estilos internos. Solo se conservará el contenido de texto puro.

Etiqueta de división: <div>
Todas las etiquetas internas que admite la etiqueta <div> se analizarán según las reglas antes mencionadas, es decir, que esta etiqueta por sí sola no implica ninguna agrupación ni sangría. Además, se ignorarán todos los atributos y estilos internos.

Etiquetas de frase: <br>, <strong> y <em>:
Solo se admiten las tres etiquetas antes mencionadas. La etiqueta <br> se puede utilizar para dividir las líneas de los párrafos, mientras que las etiquetas <strong> y <em> se pueden usar para destacar texto importante. Se ignorará cualquier otra etiqueta de frase.

Etiquetas no admitidas:

• No se permiten las etiquetas <html>, <header> ni <body>.
• No se admiten otras etiquetas que no sean las mencionadas arriba (por ejemplo, <table>, <td>, etc.).
  Las URL, las anclas y los vínculos se quitarán y nunca se mostrarán a los usuarios finales. Si deseas incluir fotos para crear una experiencia del usuario enriquecida, utiliza el campo "related_media" que se menciona a continuación para enviar las URL de tus fotos.
  

Notas importantes:

• Usa solamente las etiquetas admitidas que se mencionan arriba, porque el contenido que aparezca entre etiquetas no compatibles se quitará, y esto podría generar una experiencia del usuario no deseada.
  
• Evita las estructuras muy anidadas, como aquellas con más de 3 niveles de anidamiento diferentes en sus encabezados o listas. Mantener una estructura plana, simple y directa ayuda a crear una mejor experiencia del usuario.
  
• Si los diseños admitidos actualmente no son suficientes para tus casos prácticos, comunícate con el equipo de Reserva con Google.
  
• El tamaño máximo recomendado es de 32,000 caracteres.

Price

Es el precio del servicio.

PriceInterpretation

Describe cómo se interpreta el precio y cómo se lo muestra al usuario. Puede utilizarse en cualquier vertical, excepto Gastronomía y Actividades, para configurar de qué manera mostrar el precio del servicio.

SchedulingRules

Reglas para reservar o cancelar una cita.

PrepaymentType

Indica si el prepago es obligatorio, opcional o no se admite.

PrepaymentTerms

Términos relacionados con el momento en que se completa el pago por adelantado

ServiceIntakeForm

Obsoleta. Usa intake_form y per_ticket_intake_form.

ServiceIntakeForm

Es un formulario que le solicita información adicional al usuario cuando reserva este servicio. (Opcional)

ServiceIntakeForm

Es un formulario que le solicita información adicional al usuario cuando reserva este servicio. Se debe completar una vez para cada entrada que reserve el usuario. (Opcional)

TaxRate

Es la tasa impositiva del servicio. Si está presente, este campo anula cualquier valor de tax_rate especificado a nivel del comercio. Un mensaje vacío (es decir, tax_rate { }) restablecerá la tasa impositiva a cero.

string

Es una lista de los ID que hacen referencia a las opciones de pago que se pueden utilizar para pagar este servicio. Las opciones de pago reales se definen a nivel del comercio y también se pueden compartir entre varios de ellos.

Deposit

Define cómo se le puede cobrar un depósito al usuario. Anula el depósito del servicio si se especificó uno. Si configuras un mensaje Deposit vacío, se quitará cualquier depósito a nivel del servicio. (Opcional)

NoShowFee

Define una tarifa por no presentarse que se le puede cobrar al usuario. Anula la tarifa por no presentarse del servicio si se especificó una. Si configuras un mensaje NoShowFee vacío, se quitará cualquier tarifa por no presentarse a nivel del servicio. (Opcional)

RequireCreditCard

Indica si el usuario debe proporcionar una tarjeta de crédito para reservar este servicio. Este campo se puede anular a nivel de la disponibilidad. (Opcional)

ActionLink

Es un vínculo de acción relacionado con este servicio. Si existe un vínculo de acción, se debe configurar el tipo (consulta a continuación) a nivel del servicio.

ServiceType

Es el tipo predefinido de este servicio. (Opcional)

TicketType

Son los tipos de entrada que se pueden reservar o comprar para este servicio, siempre y cuando se admitan las entradas. (Opcional)

RelatedMedia

Son las fotos relacionadas con este servicio. Google rastreará y almacenará el contenido multimedia para asegurarse de que se muestren a los usuarios finales de la manera más eficiente. (Opcional)

ServiceAttributeValueId

Son los valores del atributo de servicio que se aplican a este servicio (opcional). Cada servicio puede tener cero o más valores para cada atributo de servicio definido en el comercio correspondiente. (Opcional)

WaitlistRules

Reglas para unirse a la lista de espera

TicketingVerticalSpecificData

Es la información adicional exclusiva de la vertical Entradas para eventos. (Opcional)

IntegrationType

Es la profundidad de la integración que admitimos para este servicio. (Opcional) No es relevante para los socios con una integración inicial. La opción de extremo a extremo siempre estará inhabilitada para estos socios.

PerOrderFee

Son las tarifas a nivel del pedido por la compra de este servicio. (Opcional)

ToursAndActivitiesContent

Son los campos de contenido específicos de la categoría Visitas guiadas y actividades.

Location

Son las ubicaciones relacionadas con este servicio. NOTAS IMPORTANTES: Si hay varias ubicaciones visitadas relacionadas con este servicio o si START_LOCATION difiere de VISITED_LOCATION, se debe especificar START_LOCATION. Ejemplo: - Para una visita guiada en bicicleta que incluye tres lugares en su recorrido, se debe especificar el de partida. - Para una visita guiada en autobús en la que hay que reunirse en el vestíbulo de un hotel antes de dirigirse al lugar de interés, se debe especificar el punto de encuentro.

Rating

Es la calificación de los usuarios para este servicio, como métrica agregada de todas las opiniones.

HomeServiceData

Información adicional exclusiva de la vertical de servicio a domicilio. (opcional)

VirtualSession

Opcional. Información sobre la sesión virtual. Es necesario para habilitar los servicios virtuales.

DirectMerchantPayment

Opcional. Es la información adicional que se debe agregar si el servicio requiere que el usuario pague directamente al comercio. NOTA IMPORTANTE: RwG no participará en esta transacción. Es obligatorio si se define virtual_session y el servicio no es gratuito o si prepayment_type NO se establece como REQUIRED.

UriTemplate

Opcional. Es una plantilla opcional que especifica cómo Google debe generar URLs a sitios externos.

ChargeTiming

Cuándo se realizará el cargo en relación con el momento de la compra.

int64

Es el tiempo en segundos antes de la hora de inicio del servicio que se le cobra al usuario el pago. Este campo solo debe establecerse cuando ChargeTiming sea CHARGE_LATER.

string

Un identificador que identifica de manera inequívoca este atributo de servicio entre otros para el mismo comercio, p.ej., "account-type".

string

Es el nombre de este atributo que se muestra al usuario, p. ej., "Tipo de cuenta".

Value

Todos los valores posibles para este atributo de servicio.

string

Un identificador que identifica de manera inequívoca este valor entre otros de este atributo de servicio, p.ej., "personales".

string

Es un nombre visible para el usuario correspondiente al valor, p.ej., "Personal".

string

Es el ID de un atributo según se define en Merchant.service_attribute, p. ej., "service-type".

string

Es el ID del valor de este atributo, p. ej., "haircut". Debe coincidir con un ID de value_id en la definición del atributo de servicio.

string

Es el nombre de recurso del servicio al que se debe aplicar este código. Tiene este formato: partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

Si se proporciona, consideraremos que las entidades de disponibilidad provistas corresponden a un resumen completo de [start_time_restrict, end_time_restrict]. Es decir, se borrará toda la disponibilidad existente si se cumple la siguiente condición:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Si se establece un mensaje de duración, la condición se verá aún más restringida:

  availability.duration == duration_restrict

Si se establece un mensaje de resources_restrict, la condición se verá aún más restringida:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Estos campos suelen utilizarse para proporcionar una actualización completa de la disponibilidad en un período determinado.

Si se establece start_time_restrict, pero se deja end_time_restrict sin definir, se interpretará que el período en cuestión abarca desde start_time_restrict en adelante.

Timestamp

Si se establece end_time_restrict, pero se deja start_time_restrict sin definir, se interpretará que el período en cuestión abarca todo el período hasta end_time_restrict.

Duration

Si se establece la duración, el alcance de la actualización se verá aún más restringido y solo abarcará la disponibilidad cuya duración coincida con aquella establecida.

Resources

Si se establece resources_restrict, el alcance de la actualización se verá aún más restringido y solo abarcará este conjunto de recursos. Todos los campos de ID de los recursos deben coincidir exactamente.

Availability

Es la nueva lista de horarios disponibles.

ServiceIntakeFormField

Son campos que se mostrarán al usuario.

bool

Si es "true", este formulario se mostrará a los clientes nuevos. Este campo es obsoleto. Esta funcionalidad no se admite para los formularios de admisión.

bool

Si es "true", este formulario se mostrará a los clientes habituales. Este campo es obsoleto. Esta funcionalidad no se admite para los formularios de admisión.

string

Es una string de un socio agregador que identifica de forma exclusiva un campo de formulario. Este ID debe ser el mismo que el que se incluya en la respuesta del campo de formulario correspondiente y debe ser único a nivel del servicio y por formulario de admisión de entrada. (Obligatorio)

FieldType

Es el tipo de este campo.

string

Es el texto que se le muestra al usuario para este campo. Este campo es obsoleto; utiliza localized_label en su lugar.

Text

Es el texto que se le muestra al usuario para este campo. El campo se puede proporcionar en varias configuraciones regionales. (obligatorio)

string

Se establece solo si el tipo de campo es LOCATION_SEARCH. Utiliza el ID de "location_id" en el campo "location" para especificar el valor de ubicación.

Text

Establece esta opción solo si el tipo de campo es MULTIPLE_CHOICE, CHECKBOXES o DROPDOWN. Se usa para enumerar posibles opciones.

bool

Indica si es obligatorio que el usuario proporcione una respuesta para este campo.

bool

Indica si se permite un valor personalizado además de las respuestas predefinidas. Esto solo es aplicable cuando el tipo de campo es LOCATION_SEARCH. (opcional)

Text

Son opciones adicionales que se proporcionaron además de los valores proporcionados. Solo se aplica cuando el tipo de campo es LOCATION_SEARCH. P.ej., Además de la lista de ubicaciones proporcionada, otra opción disponible puede ser "Me comunicaré con el proveedor más tarde". (opcional)

string

Si solo se debe mostrar esta pregunta cuando el usuario reserva ciertos tipos de entrada, este campo se debería establecer como el conjunto de ID de tipos de entrada aplicables. Deja el campo vacío si la pregunta siempre es aplicable.

Text

Es el texto de la sugerencia para la entrada, que aparece como un marcador de posición de texto. Esto solo se aplica cuando el tipo de campo es SHORT_ANSWER o PARAGRAPH. (opcional)

int32

Es una tasa impositiva en milésimas de un punto porcentual, lo que da 6 decimales de precisión. Por ejemplo, si la tasa impositiva es del 7.253%, este campo se debe establecer en 7253000.

Si este campo no se define o se establece en 0, el precio total que se cobra a un usuario por cualquier servicio provisto por este comercio es el precio exacto especificado en Service.price. Se supone que el precio del servicio está exento de impuestos o que ya incluye los impuestos aplicables. Los impuestos no se mostrarán al usuario como una línea de pedido separada.

Si este campo se establece en un valor distinto de cero, el precio total que se le cobrará a un usuario por cualquier servicio provisto por este comercio incluirá el precio del servicio más el impuesto calculado con la tasa impositiva proporcionada aquí. Las fracciones de la unidad monetaria más pequeña (por ejemplo, fracciones de un centavo) se redondearán al número entero más cercano. Los impuestos se mostrarán al usuario como un elemento de una sola línea aparte.

string

Es un campo opcional que incluye la URL de los Términos y Condiciones.

string

Es el texto que se mostrará al usuario. Utiliza el campo localized_text que figura a continuación para las integraciones nuevas.

Text

Es el texto localizado que se le mostrará al usuario.

string

Es un valor de texto en una configuración regional desconocida. Es obligatorio solo si el campo localized_value está vacío. La configuración regional de este valor puede depender del socio o del proveedor de servicios, por lo que no se debe suponer que es un idioma específico.

LocalizedString

Son los valores de texto por configuración regional. Este campo es opcional.

string

El ID de entrada se utiliza para diferenciar los diferentes tipos de entrada del mismo servicio y solo se espera que sea único dentro de un servicio.

string

Es una descripción breve de este TicketType.

Puede mostrarse al usuario, p. ej., "adulto", "niño", "veterano", "fila J", etc. Este campo es obligatorio, por lo que cada tipo de entrada debe tener una descripción para que se muestre al usuario. Este campo es obsoleto; utiliza localized_short_description en su lugar.

Text

Es una descripción breve de la compatibilidad de este TicketType con i18n.

Puede mostrarse al usuario, p. ej., "adulto", "niño", "veterano", "fila J", etc. Este campo es obligatorio, por lo que cada tipo de entrada debe tener una descripción para mostrarle al usuario. Se pueden proporcionar valores separados para cada configuración regional.

Price

Es el precio de una sola entrada de este tipo, sin incluir impuestos. Se aplicará a las entradas la tasa impositiva definida a nivel del servicio.

PerTicketFee

Son las tarifas adicionales por la compra de esta entrada. (opcional)

PriceDisplayType

Opcional. Es el tipo de visualización de precio predeterminado de una sola entrada de este tipo.

string

Es la descripción de cualquier opción adicional que represente este tipo de entrada, si corresponde. Este campo es obsoleto; utiliza localized_option_description en su lugar.

Text

Es la descripción de cualquier opción adicional que este tipo de entrada represente, si corresponde. Se pueden proporcionar valores separados para cada configuración regional.

Las opciones adicionales son útiles cuando el tipo de entrada representa varias dimensiones.

Ejemplo 1: Para una entrada con los diferentes tipos "adulto" y "niño" y el idioma como una opción adicional, la lista de TicketType esperada sería la siguiente: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adulto" } localized_option_description { value: "inglés" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adulto" } localized_option_description { value: "español" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "niño" } localized_option_description { value: "inglés" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "niño" } localized_option_description { value: "español" } }

Ejemplo 2: Para un alquiler de kayak de varias horas con el complemento opcional de bolsa impermeable, el campo shortDescription podría ser "3 horas" y el campo optionDescription podría ser "con bolsa impermeable" o "sin bolsa impermeable": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 horas" } localized_option_description { value: "inglés" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 horas" } localized_option_description { value: "español" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 horas" } localized_option_description { value: "inglés" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 horas" } localized_option_description { value: "español" } }

Este campo es opcional, pero si cualquier tipo de entrada dentro del servicio tiene configurado este campo, esperamos que todos los demás tipos de entrada también lo tengan (se podría utilizar un campo option_description predeterminado). P. ej., la lista [{ticket_type_1, adulto, inglés}, {ticket_type_1, adulto, ''}] no es válida.

Solo se admiten dos etiquetas de formato HTML: y
. Están diseñadas para especificar opciones con un título y una descripción detallada, por ejemplo: "Asientos premium
. Esta opción ofrece ubicaciones en salas privadas, con asientos sumamente cómodos, TV privadas y servicio de comida y bebida en el lugar. Estos asientos ofrecen vistas pintorescas del campo".

InventoryType

Opcional. Tipo de inventario predeterminado para un solo ticket de este tipo.

EventCategory

Es la categoría del evento. Se establece solo cuando el evento corresponde a una de las categorías predefinidas. (Opcional)

string

Es la URL del evento en el sitio web del socio. (Opcional)

Entity

Es una lista de entidades relacionadas con el evento. (opcional)

AttendanceMode

Obligatorio. Es el tipo de asistencia al evento.

string

Opcional. Es la URL en la que se puede mirar el evento.

Text

Opcional. Organizador que organiza el evento.

string

Opcional. URL del organizador que organiza el evento.

OrganizerType

Opcional. Es el tipo de organizador.

string

Obligatorio. Es la URL de las páginas en las que se puede encontrar la información o las descripciones del evento.

EventState

Opcional. Estado del evento.

Text

Opcional. El nombre de la marca localizado

EventCreator

Opcional. Información sobre el creador del evento.

string

Es un identificador único de la entidad en la base de datos del socio. (Opcional)

string

Es el nombre de la entidad. (Obligatorio)

string

Es la URL de la página web que describe la entidad de manera clara. Esta es la página web de la entidad en el sitio web del socio, si corresponde. Para otras URL públicas de la entidad, utiliza relevant_url en public_identification_data. (Opcional)

EntityType

Es el tipo de entidad. (Opcional)

EntityRole

Es la función de la entidad en el evento. (Opcional)

PublicIdentificationData

Son referencias públicas de la entidad. (Opcional)

string

Opcional. Es el nombre del creador del evento. Sin restricción de caracteres.

string

Es la URL pública de cualquier página web dedicada exclusivamente al tema. Esto puede incluir sitios web oficiales, discografías, plataformas de redes sociales, páginas de Wikipedia o IMDb, p. ej., https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959 y https://twitter.com/acmilan. (opcional)

string

Es el identificador de MusicBrainz de 36 caracteres correspondiente al artista o demás entidades musicales, si corresponde. Consulta https://musicbrainz.org/doc/MusicBrainz_Identifier. (Opcional)

Timestamp

El límite inferior del intervalo de tiempo.

Timestamp

Límite superior del intervalo de tiempo.

map<string, string>

Una configuración de asignación de token suele tener un campo tokenization_parameter cuya clave es "gateway" y cuyo valor es el nombre del procesador.

El resto de los parámetros dependen del procesador. Consulta la documentación de Google Pay para obtener más información.

Ejemplo de Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Ejemplo de Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Ejemplo de Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Incluye los datos de facturación del usuario en el token de pago, tal como se ingresaron en Google Pay con su forma de pago (consulta la información anterior). Si dejas el campo vacío, equivale a especificar MIN.