Zastępuje wartość 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 zostać zastosowany ten wskaźnik. 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 |
Jeśli podane encje dostępności zostaną podane, uznamy je za pełny zrzut z okresu [startTimeRestrict, endTimeRestrict). Oznacza to, że cała istniejąca dostępność zostanie usunięta, jeśli zostanie spełniony ten warunek:
Jeśli ustawiony jest komunikat o czasie trwania, warunek jest jeszcze bardziej ograniczony:
Jeśli ustawiono komunikat o ograniczeniach dotyczących zasobów, warunek jest jeszcze bardziej ograniczony:
Te pola są zwykle używane do zapewnienia pełnej aktualizacji dostępności w danym przedziale czasu. Ustawienie elementu startTimeRestrict z pozostawieniem nieskonfigurowanej funkcji endTimeRestrict jest interpretowane jako oznaczanie, że cały czas zaczyna się od startTimeRestrict. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
serviceAvailability.endTimeRestrict |
Ustawienie endTimeRestrict przy pozostawieniu wartości startTimeRestrict nieustawionego będzie interpretowane jako oznaczanie całego czasu aż do zakończenia czasu endTimeRestrict. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
serviceAvailability.durationRestrict |
Ustawienie czasu trwania jeszcze bardziej ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania. Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
serviceAvailability.resourcesRestrict |
Ustawienie ograniczeń 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 wraz z informacjami o tym, do kogo i kiedy należy aplikować.
Zapis JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Pola | |
---|---|
name |
Nazwa zasobu usługi, do której ma zostać zastosowany ten wskaźnik. W formacie |
startTimeRestrict |
Jeśli podane encje dostępności zostaną podane, uznamy je za pełny zrzut z okresu [startTimeRestrict, endTimeRestrict). Oznacza to, że cała istniejąca dostępność zostanie usunięta, jeśli zostanie spełniony ten warunek:
Jeśli ustawiony jest komunikat o czasie trwania, warunek jest jeszcze bardziej ograniczony:
Jeśli ustawiono komunikat o ograniczeniach dotyczących zasobów, warunek jest jeszcze bardziej ograniczony:
Te pola są zwykle używane do zapewnienia pełnej aktualizacji dostępności w danym przedziale czasu. Ustawienie elementu startTimeRestrict z pozostawieniem nieskonfigurowanej funkcji endTimeRestrict jest interpretowane jako oznaczanie, że cały czas zaczyna się od startTimeRestrict. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
endTimeRestrict |
Ustawienie endTimeRestrict przy pozostawieniu wartości startTimeRestrict nieustawionego będzie interpretowane jako oznaczanie całego czasu aż do zakończenia czasu endTimeRestrict. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
durationRestrict |
Ustawienie czasu trwania jeszcze bardziej ogranicza zakres aktualizacji tylko do dostępności z pasującym czasem trwania. Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
resourcesRestrict |
Ustawienie ograniczeń 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