REST Resource: settings.datasources

資源:DataSource

資料來源是待建立索引項目的邏輯命名空間。所有項目都必須屬於某個資料來源。如要將項目編入索引,請務必先完成這項前置作業。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "shortName": string,
  "indexingServiceAccounts": [
    string
  ],
  "disableServing": boolean,
  "disableModifications": boolean,
  "itemsVisibility": [
    {
      object (GSuitePrincipal)
    }
  ],
  "returnThumbnailUrls": boolean,
  "operationIds": [
    string
  ]
}
欄位
name

string

資料來源資源的名稱。格式:datasources/{sourceId}。

建立資料來源時,系統會忽略這個名稱。

displayName

string

必要欄位。資料來源的顯示名稱。長度上限為 300 個半形字元。

shortName

string

來源的簡稱或別名,這個值將用於比對「來源」運算子。例如,如果簡稱是 <value>,則 <value> 這樣的查詢只會傳回這個來源的結果。所有資料來源的值皆不得重複。值只能包含英數字元 (a-zA-Z0-9)。值的開頭不能是「google」且不得為下列任何一種:郵件、gmail、文件、雲端硬碟、群組、協作平台、日曆、Hangouts、Google+、Keep、使用者、團隊。長度上限為 32 個半形字元。

indexingServiceAccounts[]

string

具備索引存取權的服務帳戶清單。

disableServing

boolean

停止提供任何搜尋或輔助結果。

disableModifications

boolean

如果值為 true,系統會將資料來源設為唯讀模式。在唯讀模式下,Indexing API 會拒絕對這個來源中項目建立索引或刪除的要求。啟用唯讀模式不會停止處理先前接受的資料。

itemsVisibility[]

object (GSuitePrincipal)

這個欄位會限制資料來源層級的項目瀏覽權限。資料來源中的項目僅限這個欄位內含的使用者和群組聯合用途。請注意,這麼做並無法確保特定項目的存取權,因為使用者必須具備所含項目的 ACL 權限。這可確保整個資料來源具備較高的存取權限,且個別項目不會在這種瀏覽權限外共用。

returnThumbnailUrls

boolean

使用者可以要求取得這個資料來源中已建立索引的項目縮圖 URI。

operationIds[]

string

目前針對這個結構定義執行的長時間執行作業 (LRO) ID。

方法

create

建立資料來源。

delete

刪除資料來源。

get

取得資料來源。

list

列出資料來源。

patch

更新資料來源。

update

更新資料來源。