Ersetzt die Verfügbarkeit (Availability
) einer vorhandenen Dienstleistung (Service
) eines Händlers, der vom angegebenen Aggregator verwaltet wird, und gibt sie zurück.
HTTP-Anfrage
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
serviceAvailability.name |
Der Ressourcenname der Dienstleistung, auf die die Verfügbarkeit angewendet werden soll, im Format |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "serviceAvailability": { "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer }, "availability": [ { "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
Felder | |
---|---|
serviceAvailability.startTimeRestrict |
Sofern angegeben, betrachten wir die angegebenen Entitäten für die Verfügbarkeit als vollständige Übersicht von [startTimeRestrict, endTimeRestrict]. Das heißt, alle vorhandenen Verfügbarkeiten werden gelöscht, wenn die folgende Bedingung erfüllt ist:
Wenn eine Nachricht für die Dauer festgelegt ist, wird die Bedingung weiter eingeschränkt:
Wenn eine "resourcesRestrict"-Nachricht festgelegt ist, wird die Bedingung weiter eingeschränkt:
Diese Felder werden normalerweise verwendet, um eine vollständige Aktualisierung der Verfügbarkeiten in einem bestimmten Zeitraum bereitzustellen. Wenn "startTimeRestrict" festgelegt ist, "endTimeRestrict" aber nicht, wird das als immer ab "startTimeRestrict" ausgelegt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
serviceAvailability.endTimeRestrict |
Wenn "endTimeRestrict" festgelegt ist, "startTimeRestrict" aber nicht, wird das als immer bis "endTimeRestrict" ausgelegt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
serviceAvailability.durationRestrict |
Wenn die Dauer festgelegt wird, werden nur die Verfügbarkeiten mit übereinstimmender Dauer aktualisiert. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
serviceAvailability.resourcesRestrict |
Wenn "resourcesRestrict" festgelegt wird, werden nur die entsprechenden Ressourcen aktualisiert. Die ID-Felder der Ressourcen müssen alle genau übereinstimmen. |
serviceAvailability.availability[] |
Die neue Liste der Verfügbarkeiten. |
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
Eine Liste der Verfügbarkeiten und auf wen/wann sie angewendet werden sollen
JSON-Darstellung |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Felder | |
---|---|
name |
Der Ressourcenname der Dienstleistung, auf die die Verfügbarkeit angewendet werden soll, im Format |
startTimeRestrict |
Sofern angegeben, betrachten wir die angegebenen Entitäten für die Verfügbarkeit als vollständige Übersicht von [startTimeRestrict, endTimeRestrict]. Das heißt, alle vorhandenen Verfügbarkeiten werden gelöscht, wenn die folgende Bedingung erfüllt ist:
Wenn eine Nachricht für die Dauer festgelegt ist, wird die Bedingung weiter eingeschränkt:
Wenn eine "resourcesRestrict"-Nachricht festgelegt ist, wird die Bedingung weiter eingeschränkt:
Diese Felder werden normalerweise verwendet, um eine vollständige Aktualisierung der Verfügbarkeiten in einem bestimmten Zeitraum bereitzustellen. Wenn "startTimeRestrict" festgelegt ist, "endTimeRestrict" aber nicht, wird das als immer ab "startTimeRestrict" ausgelegt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
endTimeRestrict |
Wenn "endTimeRestrict" festgelegt ist, "startTimeRestrict" aber nicht, wird das als immer bis "endTimeRestrict" ausgelegt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
durationRestrict |
Wenn die Dauer festgelegt wird, werden nur die Verfügbarkeiten mit übereinstimmender Dauer aktualisiert. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
resourcesRestrict |
Wenn "resourcesRestrict" festgelegt wird, werden nur die entsprechenden Ressourcen aktualisiert. Die ID-Felder der Ressourcen müssen alle genau übereinstimmen. |
availability[] |
Die neue Liste der Verfügbarkeiten. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/mapsbooking