Zastępuje atrybut Availability
istniejącego Service
sprzedawcy zarządzanego przez określonego pośrednika i zwraca tę wartość.
Żądanie HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
serviceAvailability.name |
Nazwa zasobu usługi, do której ma być zastosowane polecenie. W formacie |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "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 ( |
Pola | |
---|---|
serviceAvailability.startTimeRestrict |
Dostarczone jednostki dostępności będą traktowane jako kompletny zrzut z [startTimeRestrict, endTimeRestrict). Oznacza to, że jeśli zostanie spełniony ten warunek, wszystkie dotychczasowe informacje o dostępności zostaną usunięte:
Jeśli zostanie ustawiony komunikat o czasie trwania, warunek będzie dodatkowo ograniczony:
Jeśli zostanie ustawiony komunikat „ResourceRestrict”, warunek będzie jeszcze bardziej ograniczony:
Te pola zwykle służą do przedstawienia pełnej aktualizacji dostępności w danym okresie. Ustawienie startTimeRestrict bez ustawienia endTimeRestrict jest interpretowane jako oznaczanie, że cały czas zaczyna się od startTimeRestrict. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
serviceAvailability.endTimeRestrict |
Ustawienie zasady endTimeRestrict przy pozostawianiu nieskonfigurowanej wartości startTimeRestrict jest interpretowane jako zasada „przez cały czas”, aż do wartości endTimeRestrict. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
serviceAvailability.durationRestrict |
Ustawienie czasu trwania ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
serviceAvailability.resourcesRestrict |
Ustawienie ograniczenia zasobów jeszcze bardziej ogranicza zakres aktualizacji tylko do tego zbioru zasobów. Wszystkie pola identyfikatorów zasobów muszą być dokładnie takie same. |
serviceAvailability.availability[] |
Nowa lista dostępności. |
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Lista dostępności oraz osób i terminów, w których mają być stosowane.
Zapis JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Pola | |
---|---|
name |
Nazwa zasobu usługi, do której ma być zastosowane polecenie. W formacie |
startTimeRestrict |
Dostarczone jednostki dostępności będą traktowane jako kompletny zrzut z [startTimeRestrict, endTimeRestrict). Oznacza to, że jeśli zostanie spełniony ten warunek, wszystkie dotychczasowe informacje o dostępności zostaną usunięte:
Jeśli zostanie ustawiony komunikat o czasie trwania, warunek będzie dodatkowo ograniczony:
Jeśli zostanie ustawiony komunikat „ResourceRestrict”, warunek będzie jeszcze bardziej ograniczony:
Te pola zwykle służą do przedstawienia pełnej aktualizacji dostępności w danym okresie. Ustawienie startTimeRestrict bez ustawienia endTimeRestrict jest interpretowane jako oznaczanie, że cały czas zaczyna się od startTimeRestrict. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
endTimeRestrict |
Ustawienie zasady endTimeRestrict przy pozostawianiu nieskonfigurowanej wartości startTimeRestrict jest interpretowane jako zasada „przez cały czas”, aż do wartości endTimeRestrict. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
durationRestrict |
Ustawienie czasu trwania ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
resourcesRestrict |
Ustawienie ograniczenia zasobów jeszcze bardziej ogranicza zakres aktualizacji tylko do tego zbioru zasobów. Wszystkie pola identyfikatorów zasobów muszą być dokładnie takie same. |
availability[] |
Nowa lista dostępności. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/mapsbooking