Method: projects.locations.collections.dataStores.sessions.create

建立工作階段。

如果要建立的 Session 已存在，系統會傳回 ALREADY_EXISTS 錯誤。

HTTP 要求

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/sessions

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標，父項資料儲存庫的完整資源名稱。格式：projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}

查詢參數

參數
sessionId

string

選用。工作階段要使用的 ID，會成為工作階段資源名稱的最終元件。

這個值的長度應為 1 至 63 個字元，有效字元為 /[a-z0-9][a-z0-9-]{0,61}[a-z0-9]/. 如未指定，系統會產生專屬 ID。

要求主體

要求主體包含 Session 的執行個體。

回應主體

如果成功，回應主體會包含新建立的 Session 執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

詳情請參閱Authentication Overview。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • discoveryengine.sessions.create

詳情請參閱 IAM 說明文件。