- HTTP 要求
 - 路徑參數
 - 要求主體
 - 回應主體
 - 授權範圍
 - IAM 權限
 - UserContent
 - GoogleDriveContent
 - TextContent
 - WebContent
 - VideoContent
 - AgentspaceContent
 
建立 Source 清單。
HTTP 要求
POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/notebooks/*}/sources:batchCreate
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
parent | 
                
                   
 這是必要旗標,表示將建立來源的父項資源。格式:projects/{project}/locations/{location}/notebooks/{notebook}  | 
              
要求主體
要求主體包含下列結構的資料:
| JSON 表示法 | 
|---|
{
  "userContents": [
    {
      object ( | 
                
| 欄位 | |
|---|---|
userContents[] | 
                  
                     
 這是必要旗標,要上傳的   | 
                
回應主體
SourceService.BatchCreateSources 方法的回應。
如果成功,回應主體會含有以下結構的資料:
| JSON 表示法 | 
|---|
{
  "sources": [
    {
      object ( | 
                  
| 欄位 | |
|---|---|
sources[] | 
                    
                       
  | 
                  
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/discoveryengine.readwrite
詳情請參閱Authentication Overview。
IAM 權限
需要 parent 資源的下列 IAM 權限:
discoveryengine.sources.create
詳情請參閱 IAM 說明文件。
UserContent
「內容」訊息是指使用者想上傳的資料。
| JSON 表示法 | 
|---|
{ // Union field  | 
              
| 欄位 | |
|---|---|
聯集欄位 content。使用者內容。content 只能是下列其中一項: | 
              |
googleDriveContent | 
                
                   
 Google 雲端硬碟中的內容。  | 
              
textContent | 
                
                   
 上傳為來源的文字內容。  | 
              
webContent | 
                
                   
 上傳做為來源的網頁內容。  | 
              
videoContent | 
                
                   
 上傳做為來源的影片內容。  | 
              
agentspaceContent | 
                
                   
 上傳為來源的 Agentspace 內容。  | 
              
GoogleDriveContent
Google 雲端硬碟中的內容。
| JSON 表示法 | 
|---|
{ "documentId": string, "mimeType": string, "sourceName": string }  | 
              
| 欄位 | |
|---|---|
documentId | 
                
                   
 所選文件的文件 ID。  | 
              
mimeType | 
                
                   
 所選文件的 MIME 類型。 這可用於區分在雲端硬碟挑選器中選取的內容類型。Google 文件請使用 application/vnd.google-apps.document,Google 簡報請使用 application/vnd.google-apps.presentation。  | 
              
sourceName | 
                
                   
 來源的顯示名稱。  | 
              
TextContent
上傳為來源的文字內容。
| JSON 表示法 | 
|---|
{ "sourceName": string, "content": string }  | 
              
| 欄位 | |
|---|---|
sourceName | 
                
                   
 文字來源的顯示名稱。  | 
              
content | 
                
                   
 來源的顯示名稱。  | 
              
WebContent
上傳做為來源的網頁內容。
| JSON 表示法 | 
|---|
{ "url": string, "sourceName": string }  | 
              
| 欄位 | |
|---|---|
url | 
                
                   
 如果提供網址,系統會在後端擷取網頁。  | 
              
sourceName | 
                
                   
 來源的顯示名稱。  | 
              
VideoContent
上傳的影片內容做為來源。
| JSON 表示法 | 
|---|
{ // Union field  | 
              
| 欄位 | |
|---|---|
聯集欄位 format。指定影片內容的格式。format 只能是下列其中一項: | 
              |
youtubeUrl | 
                
                   
 影片內容的 YouTube 網址。  | 
              
AgentspaceContent
上傳為來源的 Agentspace 內容。
| JSON 表示法 | 
|---|
{ "documentName": string, "engineName": string, "ideaforgeIdeaName": string }  | 
              
| 欄位 | |
|---|---|
documentName | 
                
                   
 (選用步驟) Agentspace 文件的完整資源名稱。格式:  | 
              
engineName | 
                
                   
 (選用步驟) 引擎,用來驗證文件的權限。格式:  | 
              
ideaforgeIdeaName | 
                
                   
 (選用步驟) 構想工廠執行個體的資源名稱。格式:  |