若只使用查詢字串呼叫 Index.Search
方法，系統會根據預設的查詢選項傳回結果：
- 以遞減順序排序傳回文件
- 一次以 20 件為一組傳回文件
- 擷取的文件包含其原始欄位
您可以使用
SearchOptions 結構體
的執行個體做為
`Search` 的引數，以變更這些選項。
SearchOptions 結構 可讓您指定一次要傳回多少文件，也可用於自訂要擷取文件的內容。您可以要求只傳回文件 ID，或要求文件只包含欄位子集。您也可以在擷取的文件中建立自訂欄位 欄位運算式 (欄位值會從文件中的其他欄位衍生)。
除了查詢選項外，`SearchOptions` 結構 也可以包含 SortOptions
結構的執行個體。使用排序選項可以變更排序順序，也可以依多個索引鍵排序結果。
SearchOptions
這些屬性控制傳回結果的數量及順序。偏移選項和游標選項 (兩者互斥) 支援分頁。 用於指定結果中要傳回哪些選定的文件。
| 屬性 | 說明 | 預設 | 上限 |
|---|---|---|---|
Limit
|
結果中傳回的文件數量上限。 | 20 | 1000
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。 上次更新時間：2026-02-14 (世界標準時間)。 |