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

Corpo da resposta

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.

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

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.