REST Resource: settings.datasources

資源：DataSource

資料來源是待建立索引項目的邏輯命名空間，所有項目都必須屬於資料來源。這是將項目編入索引至 Cloud Search 前的必要條件。

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

來源的簡稱或別名。這個值會用於比對「source」運算子。例如，如果簡稱為 <value>，source:<value> 等查詢只會傳回這個來源的結果。所有資料來源的值皆不得重複。這個值只能包含英數字元 (a-zA-Z0-9)。這個值不得以「google」開頭，而且不得為下列任一值：mail、gmail、docs、drive、群組、網站、日曆、Hangouts、gplus、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

 更新資料來源。