- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Sostituisce il Availability
di un Service
esistente di un commerciante gestito dall'aggregatore specificato e lo restituisce.
Richiesta HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
service |
Il nome della risorsa del servizio a cui applicare questa impostazione. Nel formato |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "serviceAvailability": { "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer, "roomDescription": { object ( |
Campi | |
---|---|
service |
Se fornite, le entità Disponibilità fornite verranno considerate uno snapshot completo da [startTimeRestrict, endTimeRestrict]. In altre parole, tutta la disponibilità esistente verrà eliminata se è vera la seguente condizione:
Se è impostato un messaggio sulla durata, la condizione è ulteriormente limitata:
Se è impostato un messaggio resourcesRestrict, la condizione è ulteriormente limitata:
Questi campi vengono in genere utilizzati per fornire un aggiornamento completo della disponibilità in un determinato intervallo di tempo. Se imposti startTimeRestrict e lasci endTimeRestrict non impostato, il valore viene interpretato come tutti i tempi a partire da startTimeRestrict. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: |
service |
L'impostazione di endTimeRestrict lasciando startTimeRestrict non impostato viene interpretata come tutti i tempi fino a endTimeRestrict. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: |
service |
L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento solo alla disponibilità con durata corrispondente. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
service |
L'impostazione resourcesRestrict limita ulteriormente l'ambito dell'aggiornamento solo a questo insieme di risorse. Tutti i campi ID delle risorse devono corrispondere esattamente. |
service |
Il nuovo elenco di disponibilità. |
Corpo della risposta
Un elenco di disponibilità e a chi/quando devono essere applicati.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Campi | |
---|---|
name |
Il nome della risorsa del servizio a cui applicare questa impostazione. Nel formato |
start |
Se fornite, le entità Disponibilità fornite verranno considerate uno snapshot completo da [startTimeRestrict, endTimeRestrict]. In altre parole, tutta la disponibilità esistente verrà eliminata se è vera la seguente condizione:
Se è impostato un messaggio sulla durata, la condizione è ulteriormente limitata:
Se è impostato un messaggio resourcesRestrict, la condizione è ulteriormente limitata:
Questi campi vengono in genere utilizzati per fornire un aggiornamento completo della disponibilità in un determinato intervallo di tempo. Se imposti startTimeRestrict e lasci endTimeRestrict non impostato, il valore viene interpretato come tutti i tempi a partire da startTimeRestrict. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: |
end |
L'impostazione di endTimeRestrict lasciando startTimeRestrict non impostato viene interpretata come tutti i tempi fino a endTimeRestrict. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: |
duration |
L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento solo alla disponibilità con durata corrispondente. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
resources |
L'impostazione resourcesRestrict limita ulteriormente l'ambito dell'aggiornamento solo a questo insieme di risorse. Tutti i campi ID delle risorse devono corrispondere esattamente. |
availability[] |
Il nuovo elenco di disponibilità. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/mapsbooking