本文說明如何在日曆模式中建立預留項目要求。使用這些要求預留高需求資源,建立附加 GPU 或 TPU 的虛擬機器 (VM) 執行個體,最多可執行 90 天。
您可以在日曆模式中使用未來預留要求,預留高需求資源來執行下列工作負載:
- 模型預先訓練工作 
- 模型微調工作 
- 高效能運算 (HPC) 模擬工作負載 
- 推論工作負載短期內增加 
Google Cloud 在日曆模式中核准要求後,您就能在指定交貨日期和時間建立 GPU 或 TPU VM,使用預留資源。如要進一步瞭解在日曆模式中建立要求時適用的規定和限制,請參閱「日曆模式中的未來預留項目要求總覽」。
事前準備
- 如果無法在日曆模式中使用未來預訂要求,表示你可能不符合存取和使用這項功能的資格。在這種情況下,請聯絡帳戶團隊或銷售團隊。
- 如要與貴機構內的其他專案共用預留容量,請確保您要在日曆模式中建立未來預留項目要求的專案 允許建立共用預留項目。否則會發生錯誤。
- 
  
  如果尚未設定驗證,請先完成設定。
  驗證可確認您的身分,以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例,可以選取下列任一選項,向 Compute Engine 進行驗證:
  
   
   
     
   
  
   
   
     
   
  
   
   
     
   
  
 
 
 
  
    
      Select the tab for how you plan to use the samples on this page: ConsoleWhen you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication. gcloud- 
 
 
  
  
   
   
  
   
   
  
   
   
     
   
  
  
   
   
  
   
   
  
   
   
  
 
 
   
   
      安裝 Google Cloud CLI。 安裝完成後,執行下列指令初始化 Google Cloud CLI: gcloud init如果您使用外部識別資訊提供者 (IdP),請先 使用聯合身分登入 gcloud CLI。 
- Set a default region and zone.
 REST如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。 安裝 Google Cloud CLI。 安裝完成後,執行下列指令初始化 Google Cloud CLI: gcloud init如果您使用外部識別資訊提供者 (IdP),請先 使用聯合身分登入 gcloud CLI。 詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。 必要的角色如要在日曆模式中建立未來預留要求,請要求管理員授予專案的 Compute Future Reservation User ( roles/compute.futureReservationUser) 身分與存取權管理角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。這個預先定義的角色具備在日曆模式中建立未來預留要求所需的權限。如要查看確切的必要權限,請展開「必要權限」部分: 所需權限如要在日曆模式中建立未來預留項目要求,必須具備下列權限: - 
                如要建立未來預留項目要求:
                  compute.futureReservations.create在專案上
- 
                如要讓 Compute Engine 自動建立預留項目,請在專案中啟用 compute.reservations.create。
- 
                如要指定執行個體範本:
                  compute.instanceTemplates.useReadOnly執行個體範本中的compute.instanceTemplates.useReadOnly
- 
                如要查看資源的未來供應情形:
                  compute.advice.calendarMode專案
 總覽如要在日曆模式中建立未來預留要求,請完成下列步驟: - 查看資源未來供應情形。查看要預留的 GPU VM 或 TPU 未來可用情形。接著,建立要求時,請指定您確認可用的資源數量、類型和預訂時間長度。 Google Cloud 提供這項資訊後,要求獲得核准的機率較高。 
- 為 GPU VM 或 TPU 建立預留要求。在日曆模式中,為 GPU VM 或 TPU 建立並提交未來的預訂要求。如果可以順利建立要求,請在一分鐘內核准。 Google Cloud 
 查看資源未來可用情形如要查看某個區域的 GPU VM 或 TPU 未來供應情形,請按照下列步驟操作: - GPU VM 最多可提前 60 天預訂 
- TPU 最多可提前 120 天預訂 
 如要查看區域中 GPU VM 或 TPU 的未來供應情形,請選取下列任一選項: 主控台在日曆模式下建立未來預留要求時,您可以查看區域中的 GPU VM 或 TPU 未來可用性。詳情請參閱本文的「為 GPU VM 或 TPU 建立預訂要求」。 gcloud如要查看區域中 GPU VM 或 TPU 的未來供應情形,請使用下列其中一個 gcloud beta compute advice calendar-mode指令。根據您要查看的資源,加入下列標記:- 如要查看 GPU VM 可用性,請加入 - --vm-count和- --machine-type旗標:- gcloud beta compute advice calendar-mode \ --vm-count=NUMBER_OF_VMS \ --machine-type=MACHINE_TYPE \ --region=REGION \ --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \ --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
- 如要查看 TPU 可用性,請加入 - --chip-count和- --tpu-version旗標:- gcloud beta compute advice calendar-mode \ --chip-count=NUMBER_OF_CHIPS \ --tpu-version=TPU_VERSION \ --region=REGION \ --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \ --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
 更改下列內容: - NUMBER_OF_VMS:要預留的 GPU VM 數量。這個值必須介於- 1至- 80之間。
- MACHINE_TYPE:要預留的 GPU 機型。請指定下列其中一個值:- A4 機型: - a4-highgpu-8g
- A3 Ultra 機型: - a3-ultragpu-8g
 
- NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是- 1、- 4、- 8、- 16、- 32、- 64、- 128、- 256、- 512或- 1024。
- TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:- TPU v6e: - V6E
- 如果是 TPU v5p: - V5P
- 如果是 TPU v5e: - V5E
 - 如果您指定 TPU v5e,則必須加上 - --workload-type旗標。將這個旗標設為要在 TPU 上執行的工作負載類型:- 對於在單一或多項作業中處理大量資料的工作負載 (例如機器學習訓練工作負載),請指定 - BATCH。
- 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 - SERVING。
 
- REGION:預留 GPU VM 或 TPU 的區域。如要查看支援的地區和區域,請參閱限制。
- FROM_START_TIME和- TO_START_TIME: 您要預留容量的最早和最晚日期。 請將這些日期設為 RFC 3339 時間戳記:- YYYY-MM-DDTHH:MM:SSOFFSET- 更改下列內容: - YYYY-MM-DD:日期格式為四位數年份、兩位數月份和兩位數日期,並以連字號分隔 (- -)。
- HH:MM:SS:時間格式為兩位數的小時 (採用 24 小時制)、兩位數的分鐘和兩位數的秒數,並以半形冒號 (- :) 分隔。
- OFFSET:時區格式為世界標準時間 (UTC) 的偏移量。 舉例來說,如要使用太平洋標準時間 (PST),請指定- -08:00。如要不使用偏移值,請指定- Z。
 
- FROM_END_TIME和- TO_END_TIME:容量預留結束的最早和最晚日期。請將這些日期設為 RFC 3339 時間戳記格式。如要指定預訂期間的時長範圍,而非結束時間,請將- --end-time-range旗標替換為- --duration-range旗標。
 輸出結果會與下列內容相似: - recommendationsPerSpec: spec: endTime: '2025-09-07T00:00:00Z' location: zones/us-east5-a otherLocations: zones/us-east5-b: details: this machine family is not supported in this zone status: NOT_SUPPORTED zones/us-east5-c: details: this machine family is not supported in this zone status: NOT_SUPPORTED recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb recommendationType: FUTURE_RESERVATION startTime: '2025-06-09T00:00:00Z'如果要求的資源可用,輸出內容會包含 startTime、endTime和location欄位。這些欄位會指定最早開始時間、最晚結束時間,以及資源可用的時區。REST如要查看某個地區的 GPU VM 或 TPU 未來可用情形,請向 beta advice.calendarMode方法發出GET要求。根據您想查看的資源,在要求主體中加入下列欄位:- 如要查看 GPU VM 可用性,請加入 - instanceCount和- machineType欄位:- POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode { "futureResourcesSpecs": { "spec": { "targetResources": { "specificSkuResources": { "instanceCount": "NUMBER_OF_VMS", "machineType": "MACHINE_TYPE" } }, "timeRangeSpec": { "startTimeNotEarlierThan": "FROM_START_TIME", "startTimeNotLaterThan": "TO_START_TIME", "endTimeNotEarlierThan": "FROM_END_TIME", "endTimeNotLaterThan": "TO_END_TIME" } } } }
- 如要查看 TPU 供應情形,請加入 - acceleratorCount和- vmFamily欄位:- POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode { "futureResourcesSpecs": { "spec": { "targetResources": { "aggregateResources": { "acceleratorCount": "NUMBER_OF_CHIPS", "vmFamily": "TPU_VERSION" } }, "timeRangeSpec": { "startTimeNotEarlierThan": "FROM_START_TIME", "startTimeNotLaterThan": "TO_START_TIME", "endTimeNotEarlierThan": "FROM_END_TIME", "endTimeNotLaterThan": "TO_END_TIME" } } } }
 更改下列內容: - PROJECT_ID:您要預留資源的專案 ID。
- REGION:要預留 GPU VM 或 TPU 的區域。如要查看支援的地區和區域,請參閱限制。
- NUMBER_OF_VMS:要預留的 GPU VM 數量。這個值必須介於- 1至- 80之間。
- MACHINE_TYPE:要預留的 GPU 機型。請指定下列其中一個值:- A4 機型: - a4-highgpu-8g
- A3 Ultra 機型: - a3-ultragpu-8g
 
- NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是- 1、- 4、- 8、- 16、- 32、- 64、- 128、- 256、- 512或- 1024。
- TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:- TPU v6e: - VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E
- 如果是 TPU v5p: - VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P
- 如果是 TPU v5e: - VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP
 - 如果指定 TPU v5e,則必須在 - aggregateResources欄位中加入- workloadType欄位。將這個欄位設為要在 TPU 上執行的工作負載類型:- 對於在單一或多項作業中處理大量資料的工作負載 (例如機器學習訓練工作負載),請指定 - BATCH。
- 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 - SERVING。
 
- FROM_START_TIME和- TO_START_TIME: 您要預留容量的最早和最晚日期。 請將這些日期設為 RFC 3339 時間戳記:- YYYY-MM-DDTHH:MM:SSOFFSET- 更改下列內容: - YYYY-MM-DD:日期格式為四位數年份、兩位數月份和兩位數日期,並以連字號分隔 (- -)。
- HH:MM:SS:時間格式為兩位數的小時 (採用 24 小時制)、兩位數的分鐘和兩位數的秒數,並以半形冒號 (- :) 分隔。
- OFFSET:時區格式為世界標準時間 (UTC) 的偏移量。 舉例來說,如要使用太平洋標準時間 (PST),請指定- -08:00。如要不使用偏移值,請指定- Z。
 
- FROM_END_TIME和- TO_END_TIME:容量預留結束的最早和最晚日期。請將這些日期設為 RFC 3339 時間戳記格式。如要指定預訂期間的時長範圍,而非結束時間,請將- endTimeNotEarlierThan和- endTimeNotLaterThan欄位替換為- minDuration和- maxDuration欄位。
 輸出結果會與下列內容相似: { "recommendations": [ { "recommendationsPerSpec": { "spec": { "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b", "recommendationType": "FUTURE_RESERVATION", "startTime": "2025-06-09T00:00:00Z", "endTime": "2025-09-07T00:00:00Z", "otherLocations": { "zones/us-east5-b": { "status": "NOT_SUPPORTED", "details": "this machine family is not supported in this zone" }, "zones/us-east5-c": { "status": "NOT_SUPPORTED", "details": "this machine family is not supported in this zone" } }, "location": "zones/us-east5-a" } } } ] }如果要求的資源可用,輸出內容會包含 startTime、endTime和location欄位。這些欄位會指定最早開始時間、最晚結束時間,以及資源可用的時區。為 GPU VM 或 TPU 建立預留要求在日曆模式中建立未來預留項目要求時,只能指定下列預留期間: - 開始時間:根據您要預留的資源,您必須指定開始時間,且該時間至少應為您建立及提交要求時的下列其中一個值: - GPU VM:87 小時 (三天又 15 小時) 
- TPU 為六小時 
 
- 結束時間:資源最多可預留 90 天。 
 如要以現有 GPU VM 做為參考來建立要求,請使用Google Cloud 控制台。否則,請選取下列其中一個選項: 主控台- 在 Google Cloud 控制台,前往「Reservations」(預留項目) 頁面。 
- 點按「Future reservations」(未來預留項目) 分頁標籤。 
- 點按 「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示,並選取「Hardware configuration」(硬體設定) 窗格。 
- 在「Configuration」(設定) 區段中,執行下列任一操作,指定要預留的 GPU VM 或 TPU 屬性: - 如要直接指定 GPU VM 或 TPU 屬性,請完成下列步驟: - 選取「指定機器類型」。 
- 按一下「GPU」或「TPU」分頁標籤,然後選取要預留的 GPU 機器類型或 TPU 版本。 
 
- 如要使用現有的執行個體範本指定 GPU VM 屬性,請選取「執行個體範本」,然後選取範本。 
- 如要使用現有 VM 做為參考,指定 GPU VM 屬性,請選取「Use existing VM」(使用現有 VM),然後選取 VM。 
 
- 如果您在上一個步驟中指定 TPU v5e (CT5LP),請在「TPU v5 workload type」(TPU v5 工作負載類型) 清單中選取下列其中一個選項: - 如要在 TPU 上執行工作負載,處理單一或多項作業中的大量資料 (例如機器學習訓練工作負載),請選取「批次」。 
- 如要在 TPU 上執行處理並行要求的工作負載,並盡量減少網路延遲,例如機器學習推論工作負載,請選取「服務」。 
 
- 在「Search for capacity」(搜尋容量) 區段中,完成下列步驟: - 在「Region」(區域) 和「Zone」(可用區) 清單中,指定要預留資源的區域和可用區。如要查看支援的地區和區域,請參閱限制。 
- 在「Total capacity needed」(所需總容量) 欄位 (預留 GPU VM 時) 或「Number of chips」(晶片數量) 清單 (預留 TPU 時),指定要預留的 GPU VM 或 TPU 晶片數量。您可以指定下列值: - 如果是 GPU VM,則值介於 - 1和- 80之間
- 如果是 TPU 晶片,值為 - 1、- 4、- 8、- 16、- 32、- 64、- 128、- 256、- 512或- 1024
 
- 在「開始時間」清單中,選取要求的開始時間。 
- 選用:在「選擇彈性開始日期」清單中,選取開始日期需要多準確。 
- 在「預留時間」欄位中,指定要預留資源的時間長度。 
- 按一下「搜尋運算資源」。接著,在「可用容量」表格中,選取其中一個可用選項,其中包含要預留的 GPU VM 或 TPU 類型、數量和預留期間。 
 
- 點選「下一步」。 
- 在「Share type」(共用類型) 部分,選取要共用所要求容量的專案: - 如要僅在專案中使用預留容量,請選取「本機」。 
- 如要與其他專案共用預留容量,請選取「共用」,按一下 「新增專案」,然後按照提示選取專案。 
 
- 點選「下一步」。 
- 在「Future reservation name」(未來預訂名稱) 欄位中,輸入要求的名稱。 
- 在「Reservation name」(保留項目名稱) 欄位中,輸入 Compute Engine 自動建立的保留項目名稱,以佈建您要求的容量。 
- 點選「建立」。 
 gcloud如要在日曆模式中建立未來預訂要求,並提交審查,請使用下列其中一個 gcloud beta compute future-reservations create指令。 根據您要保留的資源,加入下列標記:- 如要預留 GPU VM,請加入 - --total-count、- --machine-type和- --deployment-type=DENSE標記:- gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --total-count=NUMBER_OF_VMS \ --machine-type=MACHINE_TYPE \ --deployment-type=DENSE \ --planning-status=SUBMITTED \ --require-specific-reservation \ --reservation-mode=CALENDAR \ --reservation-name=RESERVATION_NAME \ --share-setting=SHARE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --zone=ZONE
- 如要預留 TPU,請加入 - --chip-count和- --tpu-version旗標:- gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --chip-count=NUMBER_OF_CHIPS \ --tpu-version=TPU_VERSION \ --planning-status=SUBMITTED \ --require-specific-reservation \ --reservation-mode=CALENDAR \ --reservation-name=RESERVATION_NAME \ --share-setting=SHARE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --zone=ZONE
 更改下列內容: - FUTURE_RESERVATION_NAME:要求的名稱。
- NUMBER_OF_VMS:要預留的 GPU VM 數量。這個值必須介於- 1至- 80之間。
- MACHINE_TYPE:要預留的 GPU 機型。請指定下列其中一個值:- A4 機型: - a4-highgpu-8g
- A3 Ultra 機型: - a3-ultragpu-8g
 
- NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是- 1、- 4、- 8、- 16、- 32、- 64、- 128、- 256、- 512或- 1024。
- TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:- TPU v6e: - V6E
- 如果是 TPU v5p: - V5P
- 如果是 TPU v5e: - V5E
 - 如果您指定 TPU v5e,則必須加上 - --workload-type旗標。將旗標設為要在 TPU 上執行的工作負載類型:- 對於在單一或多項作業中處理大量資料的工作負載 (例如機器學習訓練工作負載),請指定 - BATCH。
- 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 - SERVING。
 
- RESERVATION_NAME:Compute Engine 自動建立的預留項目名稱,用於佈建您要求的容量。
- SHARE_TYPE:貴機構的其他專案是否可使用預留容量。請指定下列其中一個值:- 如要僅在專案中使用容量,請按照下列步驟操作: - local
- 如要與其他專案共用容量,請按照下列步驟操作: - projects
 - 如果您指定 - projects,則必須加入- --share-with旗標,並將其設為以半形逗號分隔的專案 ID 清單,例如- project-1,project-2。您最多可以在機構內指定 100 個專案。請勿在這份清單中加入專案 ID。根據預設,您可以耗用預留容量。
- START_TIME:請求的開始時間,格式為 RFC 3339 時間戳記。
- END_TIME:預訂期間的結束時間,格式為 RFC 3339 時間戳記。如要指定預訂期間的秒數,而非結束時間,請將- --end-time旗標替換為- --duration旗標。
- ZONE:要預留資源的可用區。
 REST如要在日曆模式中建立未來預留要求,並提交審查,請將下列 POST要求傳送至 betafutureReservations.insert方法。根據您要保留的資源,在要求主體中加入下列欄位:- 如要預留 GPU VM,請加入 - totalCount和- machineType欄位,以及設為- DENSE的- deploymentType欄位:- POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "name": "FUTURE_RESERVATION_NAME", "autoDeleteAutoCreatedReservations": true, "deploymentType": "DENSE", "planningStatus": "SUBMITTED", "reservationMode": "CALENDAR", "reservationName": "RESERVATION_NAME", "shareSettings": { "shareType": "SHARE_TYPE" }, "specificReservationRequired": true, "specificSkuProperties": { "totalCount": NUMBER_OF_VMS, "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
- 如要預留 TPU,請加入 - acceleratorCount和- vmFamily欄位:- POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "name": "FUTURE_RESERVATION_NAME", "autoDeleteAutoCreatedReservations": true, "planningStatus": "SUBMITTED", "reservationMode": "CALENDAR", "reservationName": "RESERVATION_NAME", "shareSettings": { "shareType": "SHARE_TYPE" }, "specificReservationRequired": true, "aggregateReservation": { "reservedResources": [ { "accelerator": { "acceleratorCount": NUMBER_OF_CHIPS } } ], "vmFamily": "TPU_VERSION" }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
 更改下列內容: - PROJECT_ID:您要建立要求的專案 ID。
- ZONE:要預留資源的可用區。
- FUTURE_RESERVATION_NAME:要求的名稱。
- RESERVATION_NAME:Compute Engine 自動建立的預留項目名稱,用於佈建您要求的容量。
- SHARE_TYPE:貴機構的其他專案是否可使用預留容量。請指定下列其中一個值:- 如要僅在專案中使用容量,請按照下列步驟操作: - LOCAL
- 如要與其他專案共用容量,請按照下列步驟操作: - SPECIFIC_PROJECTS
 - 如果您指定 - SPECIFIC_PROJECTS,則必須在- shareSettings欄位中加入- projectMap欄位,指定要共用容量的專案。您最多可以在機構內指定 100 個專案。請勿指定專案 ID。根據預設,您可以取用預留容量。- 舉例來說,如要與另外兩個專案共用要求的容量,請加入下列項目: - "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } }- 將 - CONSUMER_PROJECT_ID_1和- CONSUMER_PROJECT_ID_2替換為您要允許使用所要求容量的兩個專案 ID。
- NUMBER_OF_VMS:要預留的 GPU VM 數量。這個值必須介於- 1至- 80之間。
- MACHINE_TYPE:要預留的 GPU 機型。請指定下列其中一個值:- A4 機型: - a4-highgpu-8g
- A3 Ultra 機型: - a3-ultragpu-8g
 
- NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是- 1、- 4、- 8、- 16、- 32、- 64、- 128、- 256、- 512或- 1024。
- TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:- TPU v6e: - VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E
- 如果是 TPU v5p: - VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P
- 如果是 TPU v5e: - VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP
 - 如果指定 TPU v5e,則必須在 - aggregateResources欄位中加入- workloadType欄位。將這個欄位設為要在 TPU 上執行的工作負載類型:- 對於在單一或多項作業中處理大量資料的工作負載 (例如機器學習訓練工作負載),請指定 - BATCH。
- 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 - SERVING。
 
- START_TIME:請求的開始時間,格式為 RFC 3339 時間戳記。
- END_TIME:預訂期間的結束時間,格式為 RFC 3339 時間戳記。如要指定預訂期限 (以秒為單位),而非結束時間,請將- endTime欄位替換為- duration欄位。
 後續步驟除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。 上次更新時間:2025-10-19 (世界標準時間)。 -