- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ExtendedServiceAvailability
Zastępuje Availability
z istniejących Services
. Wywołanie zbiorcze nie gwarantuje niepodzielności. Zwrócone zostaną tylko przedziały dostępności, które zostały zaktualizowane.
Żądanie HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Format: |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
Pola | |
---|---|
extendedServiceAvailability[] |
Rozszerzona dostępność usługi, która zastępuje istniejące przedziały dostępności. |
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Odpowiedź zbiorcza zastępująca wiele przedziałów dostępności komponentu Service
. W tej wiadomości zostaną uwzględnione tylko zaktualizowane przedziały, które zostały zaktualizowane
Zapis JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
Pola | |
---|---|
extendedServiceAvailability[] |
Komunikaty o rozszerzonej dostępności usługi, które zostały użyte do zastąpienia istniejących przedziałów dostępności, zostały zaktualizowane. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/mapsbooking
ExtendedServiceAvailability
Lista dostępności oraz osób i terminów, w których mają być stosowane.
Zapis JSON |
---|
{ "merchantId": string, "serviceId": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
Pola | |
---|---|
merchantId |
To pole jest wymagane, aby określić, do którego sprzedawcy należą poniższe komunikaty o dostępności. |
serviceId |
To pole jest wymagane, aby określić, do której usługi należą poniższe komunikaty o dostępności. |
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. |