Method: inventory.partners.availability.replace

Substitui a Availability dos Services existentes. Essa chamada em lote não garante a atomicidade. Serão retornados somente os horários disponíveis atualizados com êxito.

Solicitação HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Formato de partners/{partner_id}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Campos
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

Disponibilidade de serviço estendida usada para substituir os horários disponíveis atuais.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Resposta em lote para substituir vários horários disponíveis de Service. Serão incluídos nesta mensagem somente os horários disponíveis atualizados com êxito.

Representação JSON
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
Campos
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

As mensagens de disponibilidade de serviço estendida foram atualizadas e usadas para substituir os horários disponíveis atuais.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/mapsbooking

ExtendedServiceAvailability

Uma lista de disponibilidade e a quem/quando elas devem ser aplicadas.

Representação JSON
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
Campos
merchantId

string

Este é um campo obrigatório para especificar a qual comerciante as mensagens de disponibilidade abaixo pertencem.

serviceId

string

Este é um campo obrigatório para especificar a qual serviço as mensagens de disponibilidade abaixo pertencem.

startTimeRestrict

string (Timestamp format)

Se esse campo for definido, consideraremos as entidades de disponibilidade indicadas como um instantâneo completo de [startTimeRestrict, endTimeRestrict). Ou seja, todas as disponibilidades existentes serão excluídas se a seguinte condição for verdadeira:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

Se uma mensagem de duração for definida, a condição será ainda mais restritiva:

  availability.duration == durationRestrict

Se uma mensagem resourcesRestrict for definida, a condição será ainda mais restritiva:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

Esses campos normalmente são usados para enviar uma atualização completa da disponibilidade em um determinado período.

Quando você define startTimeRestrict, mas não endTimeRestrict, todo o período desde o valor definido em startTimeRestrict é considerado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

endTimeRestrict

string (Timestamp format)

Quando você define endTimeRestrict, mas não startTimeRestrict, todo o período até o valor definido em endTimeRestrict é considerado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

durationRestrict

string (Duration format)

Definir a duração restringe ainda mais o escopo da atualização à disponibilidade com período correspondente.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

resourcesRestrict

object (Resources)

Definir resourcesRestrict restringe ainda mais o escopo da atualização a esse conjunto de recursos. Todos os campos de código dos recursos precisam corresponder.

availability[]

object (Availability)

A nova lista de disponibilidade.