REST Resource: inventory.partners.merchants.services.availability

{
  "startTime": string,
  "duration": string,
  "spotsTotal": string,
  "spotsOpen": string,
  "availabilityTag": string,
  "resources": {
    object (Resources)
  },
  "paymentOptionId": [
    string
  ],
  "recurrence": {
    object (Recurrence)
  },
  "scheduleException": [
    {
      object (ScheduleException)
    }
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "prepayment": {
    object (Prepayment)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "ticketTypeId": [
    string
  ],
  "durationRequirement": enum (DurationRequirement),
  "schedulingRuleOverrides": {
    object (SchedulingRuleOverrides)
  },
  "confirmationMode": enum (ConfirmationMode),
  "linkoutRequiredReason": enum (LinkoutRequiredReason)
}

string (Timestamp format)

Hora de inicio del espacio disponible.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Es la duración del espacio disponible.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

string (int64 format)

Es la cantidad de cupos totales y disponibles para este espacio. Ejemplos:

• Una clase de yoga con 10 cupos y 3 reservados: availability {spotsTotal: 10, spotsOpen: 7 ...}
• Una sesión de masajes en silla que ya está reservada: availability {spotsTotal: 1, spotsOpen: 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 spotsTotal=1 y spotsOpen=1.
• El uso de ScheduleException implica spotsTotal=1 y spotsOpen=0.

string (int64 format)

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

object (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 { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 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.

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

object (ScheduleException)

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

object (Deposit)

Representa el depósito opcional para este espacio disponible. Anula el depósito de servicio si se especificó uno.

object (NoShowFee)

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

object (Prepayment)

Opcional. Es la información opcional de pago por adelantado para esta disponibilidad.

enum (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 entradas: TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Youth weekends"}

Para representar el inventario durante los días de semana, se puede utilizar lo siguiente: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. Para representar el inventario durante las festividades, se puede utilizar lo siguiente: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}

• Servicio con tres tipos de entrada: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

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

(opcional)

enum (DurationRequirement)

Es el requisito de mostrar la duración de los intervalos o la hora de finalización. Este campo se ignorará si el espacio no está disponible. No se usa en la vertical Cosas que hacer. (opcional)

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

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

enum (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)

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

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 que se lo pueda correlacionar con las reservas anteriores. Si staffName está presente, este campo también debe estarlo.

string

Este es el nombre opcional de un miembro del personal que proporciona 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. Si staffId está presente, este campo también debe estarlo.

string

Se trata de un ID opcional para la sala en la que se encuentra 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 que se lo pueda correlacionar con las reservas anteriores. Si roomName está presente, este campo también debe estarlo.

string

Es un nombre opcional para la sala en la que se encuentra 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 roomId 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.

integer

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 espacios de tiempo disponibles al mismo tiempo. En cada uno, se puede especificar un tamaño de fiesta diferente si, por ejemplo, pueden sentarse 2, 3 o 4 personas con una reserva.

object (Text)

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

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

string (Duration format)

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

Ejemplo: Un espacio disponible con el campo duration establecido en 20 min, repeatEvery en 30 min, startTime en 9:00 a.m. y repeatUntil en 11:00 a.m. generará los siguientes espacios 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)

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

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

Ejemplo: Si el mensaje Recurrence tuviera el campo duration establecido en 20 min, repeatEvery en 30 min, startTime en 9:00 a.m. y repeatUntil en 11:00 a.m. y utilizaras un mensaje ScheduleException con el campo timeRange configurado con el período de 9:45 a.m. a 11:00 a.m., los siguientes espacios 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 espacio disponible que comienza a las 11 a.m. no se verá afectado.

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

Recipiente para los detalles de los precios.

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

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

object (Price)

Es el precio de un servicio o una tarifa.

object (PriceRange)

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

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

Importe mínimo.

object (Price)

Importe máximo Siempre debe ser superior a minPrice.

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

Indica la última hora (en segundos) en que se puede reservar este espacio disponible. Esta marca de tiempo debe ser anterior al campo startSec del espacio disponible que debe respetarse (si los usuarios deben poder reservar después de la hora de inicio, usa SchedulingRules.min_booking_before_end_time a nivel del servicio). Si está presente, anulará todo lo que se especifique en el campo min_booking_buffer del objeto SchedulingRules del servicio correspondiente.

string (int64 format)

Indica la primera hora (en segundos) en que se puede reservar este espacio. Esta marca de tiempo debe ser anterior al campo startSec del espacio disponible o al campo lastBookableSec si está especificado.

string (int64 format)

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)