REST Resource: inventory.partners.merchants.services.availability

{
  "startTime": string,
  "duration": string,
  "spotsTotal": string,
  "spotsOpen": string,
  "availabilityTag": string,
  "resources": {
    object (Resources)
  },
  "paymentOptionId": [
    string
  ],
  "recurrence": {
    object (Recurrence)
  },
  "scheduleException": [
    {
      object (ScheduleException)
    }
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "prepayment": {
    object (Prepayment)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "ticketTypeId": [
    string
  ],
  "durationRequirement": enum (DurationRequirement),
  "schedulingRuleOverrides": {
    object (SchedulingRuleOverrides)
  },
  "confirmationMode": enum (ConfirmationMode),
  "linkoutRequiredReason": enum (LinkoutRequiredReason)
}

string (Timestamp format)

予約スロットの開始時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Duration format)

予約枠の期間

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

string (int64 format)

この予約枠の合計スポット数と空きスポット数。例:

• 10 個のスポットがあるヨガクラスで 3 個が予約済みの場合: availability {spotsTotal: 10, spotsOpen: 7 ...}
• チェア マッサージの 1 回の施術が完全に予約済みの場合: availability {spotsTotal: 1, spotsOpen: 0 ...}

注: 以下で定義されている空き状況の圧縮形式を使用してリクエストを送信すると、これら 2 つのフィールドが推定されます。

• Recurrence では、spotsTotal=1 と spotsOpen=1 が推定されます。
• ScheduleException では、spotsTotal=1 と spotsOpen=0 が推定されます。

string (int64 format)

空きスポット数。

string

この予約枠を識別するための不透明型文字列（省略可）。設定すると、予約、予約の更新、予約のキャンセルを行うリクエストに含まれます。

object (Resources)

異なるスタッフや部屋がサービスに含まれている場合に、個々の予約枠を区別するために使用されるリソース（省略可）。

たとえば、1 つのヨガクラスに 2 人のインストラクターがいる場合:

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

このスロットの支払いに使用できる支払いオプションを参照する ID のリスト。実際の支払いオプションは Merchant レベルで定義され、複数の Merchant 間で共有することもできます。

このフィールドは、サービス メッセージで指定された payment_option_id をオーバーライドします。同様に、ここで指定された payment_option_id はサービス メッセージに存在する必要はありませんが、Merchant レベルで定義する必要があります。

object (Recurrence)

空き状況の繰り返しに関する情報で、複数の開始時刻を表します。繰り返しには 1 営業日の予約が含まれている必要があります。

object (ScheduleException)

このサービスをスケジュールできない時間。scheduleException メッセージの数を制限するには、隣接する例外を結合することを検討してください。

object (Deposit)

この空き情報の保証料（省略可）。サービスの保証料が指定されている場合は、それをオーバーライドします。

object (NoShowFee)

この空き状況用の無断キャンセル料（省略可）。サービスの無断キャンセル料が指定されている場合は、それをオーバーライドします。

object (Prepayment)

省略可。この空き状況のオプションの前払い情報。

enum (RequireCreditCard)

この予約枠を予約するために、ユーザがクレジット カードを提供する必要があるかどうかを示します。値が設定されていない場合、サービスレベルから値が継承されます（設定されている場合）。（省略可）

string

この空き状況スロットでサポートされているチケットタイプのリストを示します。設定されていない場合、親サービスのすべてのチケットタイプをこのスロットで使用できます。なお、このフィールドの値は親サービスで定義する必要があります。例:

• チケットタイプが 4 つあるサービスの場合: TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Youth weekends"}

平日の在庫を表すには: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}。祝日の在庫を表すには: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}。

• チケットタイプが 3 つあるサービスの場合: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

このタイムスロットで 3 つのチケットタイプすべてが使用可能であることを示すには、availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} または `availability {...}' を使用します（このスロットには ticketTypeId を設定しないでください）。

（省略可）

enum (DurationRequirement)

スロットの所要時間や終了時間を表示する必要がある。スロットを使用できない場合、このフィールドは無視されます。「おすすめスポット」カテゴリでは使用されません。（省略可）

object (SchedulingRuleOverrides)

空き状況のスケジュール設定ルール。フィールドに値が入力されている場合は、サービスレベルの SchedulingRules 上の対応するスケジュール設定ルールをオーバーライドします。

enum (ConfirmationMode)

この空き状況の予約時に使用される確認モード。CONFIRMATION_MODE_SYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に確認または拒否されます。CONFIRMATION_MODE_ASYNCHRONOUS の確認モードで空き状況の予約を作成しようとした場合、即座に拒否されるか、保留中のステータスで作成されます。

enum (LinkoutRequiredReason)

省略可。このスロットにリンクアウトが必要な理由。設定する場合は、このスロットの Merchant リソースに有効な LinkoutTemplate が必要です。（省略可）

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

string

サービスを提供するスタッフの ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードでスタッフを識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。staffName が存在する場合、このフィールドは必須です。

string

サービスを提供するスタッフ メンバーの名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。staffId が存在する場合、このフィールドは必須です。

string

サービスが提供される部屋の ID（省略可）。このフィールドでは、すべての販売者、サービス、空き状況レコードで部屋を識別します。また、過去の予約と関連付けることができるよう、時間が経過しても変更しないでください。roomName が存在する場合、このフィールドは必須です。

string

サービスが提供される部屋の名前（省略可）。このフィールドは、予約を行うユーザーに表示されるため、不透明型識別子ではなく、人が読んで理解できる形式にする必要があります。（省略可、ただし roomId が存在する場合は必須）ダイニングでは、部屋の名前はバーやパティオなどの座席エリアにのみ使用し、固定料金メニュー、特別なアクティビティ、空席以外の値（予約や夕食など）には使用しないでください。デフォルトの座席エリアには部屋を関連付けないことを強くおすすめします。

integer

Dining のみ: この時間枠に対応できる人数。1 つのレストランで同じ時間に複数の Slot を関連付けることができます。たとえば、2 人、3 人、または 4 人を予約できる場合は、それぞれに異なる partySize を指定することが可能です。

object (Text)

省略可。ローカライズされた客室の説明。設定する場合は、デフォルト値を指定する必要があります。販売者の言語 / 地域で一般的な言語も指定することをおすすめします。（省略可）

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

空き状況が繰り返される最終時間として含める UTC タイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Duration format)

後続の予約枠との間隔を定義します。

例: 空き状況の duration が 20 分、repeatEvery が 30 分、startTime が午前 9 時、repeatUntil が午前 11 時の場合、スロットは 午前 9 時～9 時 20 分、午前 9 時 30 分～9 時 50 分、午前 10 時～10 時 20 分、午前 10 時 30 分～10 時 50 分、午前 11 時～11 時 20 分となります。（必須）

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

例外の時間帯。繰り返しで記述されたスロット内で、例外の時間帯（左閉右開）が重複する時間帯は、利用不可と見なされます。

例: 繰り返しの duration が 20 分、repeatEvery が 30 分、startTime が午前 9 時、repeatUntil が午前 11 時で指定され、ScheduleException の timeRange が午前 9 時 45 分～11 時で指定されている場合、午前 9 時 30 分～9 時 50 分、午前 10 時～10 時 20 分、午前 10 時 30 分～10 時 50 分のスロットは利用できなくなります。

例外の時間帯は左閉右開であるため、午前 11:00 から始まる予約枠は影響を受けません。

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

料金の詳細を示すコンテナ。

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

料金または料金帯の適用方法（1 人あたりまたは固定）を定義します。

object (Price)

サービスの価格または料金。

object (PriceRange)

サービスの上限または下限、または料金の上限または下限。

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

最低額。

object (Price)

上限額。常に minPrice より大きくする必要があります。

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

このスロットを予約できる最終時間（秒）。このタイムスタンプは、該当するスロットの startSec の前に設定する必要があります（開始時間後にユーザーが予約できるようにする場合は、SchedulingRules.min_booking_before_end_time のサービスレベルを使用します）。指定されている場合、対応する Service の SchedulingRules の min_booking_buffer で指定されたすべての値をオーバーライドします。

string (int64 format)

この予約枠を予約できる開始時刻（秒）。このタイムスタンプは、スロットの startSec の前か、指定されている場合は lastBookableSec の前に指定する必要があります。

string (int64 format)

設定されている場合、この特定の予約スロットを Google で予約する際にキャンセルできる最終時間（Unix エポックからの秒数）。このフィールドは、サービスレベルのキャンセル ルールをオーバーライドします。（省略可）