Google 的 API 平台為使用該平台建立的所有 Google API 提供一組通用功能。為了使用及控制這類功能，該平台預先訂立了一組稱為「系統參數」的要求參數。這些參數可在所有 Google REST API 和 gRPC API 中使用。系統參數可透過 HTTP 查詢參數或 HTTP 標頭指定。如果是 Google gRPC API，則只能透過 HTTP 標頭指定。
大多數使用者不需要直接使用這些參數。但 Google 提供的用戶端程式庫常常會用到。如果您需要編寫自訂程式碼來直接存取 Google API，系統參數可發揮不少功用，例如協助控制 JSON 美化作業或用來指定 API 金鑰。
HTTP 對應
如果是 HTTP 要求，系統參數會以網址查詢參數或 HTTP 要求標頭的形式傳送。舉例來說，如果您有系統參數 $foo，系統會將其以 ?$foo=xxx 形式傳送至網址，或以 ?%24foo=xxx 形式傳送至網址 (如果網址已編碼)。詳情請參閱下表。
gRPC 對應
如果是 gRPC 要求，系統參數會以小寫鍵的形式，做為 HTTP 要求標頭傳送。詳情請參閱下方表格。
定義
下表列出所有系統參數及其定義。
| 網址查詢參數 | HTTP/gRPC 標頭 | 說明 |
|---|---|---|
Authorization |
驗證憑證。詳情請參閱「驗證總覽」。 | |
$alt、alt |
替代回應格式。支援的值為 json (預設值)、media、proto、sse (JSON 串流)。 |
|
$.xgafv |
JSON 錯誤格式。支援的值為 1、2 (預設值)。錯誤格式 1 只應由 Google API 用戶端程式庫使用。 |
|
$callback、callback |
JSONP 回呼參數。 | |
$ct |
Content-Type |
覆寫 HTTP Content-Type 要求標頭。 |
$fields、fields |
X-Goog-FieldMask |
FieldMask，用於篩選回應。如果留空，除非另有說明，否則應傳回所有欄位。 |
X-HTTP-Method-Override |
要求要使用的 HTTP 方法。某些網路 Proxy 只接受部分 HTTP 方法。 | |
$key、key |
X-Goog-Api-Key |
Google API 金鑰。詳情請參閱 https://cloud.google.com/docs/authentication/api-keys。 |
passwd、password |
會保留下來，以防網址中出現密碼。 | |
$prettyPrint、prettyPrint |
美化 JSON 回應。支援的值為 true (預設值)、false。 |
|
quotaUser |
X-Goog-Quota-User |
用於計算每位使用者配額的虛擬使用者 ID。如未指定，系統會使用經過驗證的主體。如果沒有經過驗證的主體，系統會使用用戶端 IP 位址。指定時，必須使用具有服務限制的有效 API 金鑰，以識別配額專案。否則，系統會忽略這個參數。 |
$outputDefaults |
JSON 回應的強制輸出 proto 預設值。 | |
$unique |
用於停用要求快取的不重複查詢參數。 | |
X-Goog-Api-Client |
API 用戶端身分識別資訊。值是以空格分隔的 NAME "/" SEMVER 字串清單，其中 NAME 應只包含小寫字母、數字和「-」，SEMVER 則應為語意版本字串。例如：X-Goog-Api-Client: python/3.5.0 grpc-google-pubsub-v1/0.1.0-beta2 linux/2.7.0。 |
|
X-Goog-Request-Reason |
包含發出要求的理由，會記錄在稽核記錄中。理由可能是支援案件票證號碼等。如果是稽核記錄，系統會根據原因中的字元，判斷是否要先將原因進行 Base64 編碼，再附加至記錄項目。如果原因只包含英文字母、數字和空格，系統會以純文字形式保留。包含其他字元的原因會採用 Base64 編碼。 | |
$userProject |
X-Goog-User-Project |
用於配額與帳單的呼叫者指定專案。呼叫者必須擁有該專案的 serviceusage.services.use 權限。 |
X-Server-Timeout |
伺服器完成處理要求的逾時時間 (以秒為單位，浮點值)。這個系統參數僅適用於不適用用戶端逾時的 REST API。 | |
x-goog-request-params |
傳遞 gRPC 要求的其他參數。值必須經過網址查詢字串編碼 (例如 key1=value1&key2=value2)。這個標頭支援的特定鍵和值，取決於所呼叫的個別 Google API 服務和方法。這個標題沒有單一的通用參數集。請務必參閱您互動的特定 API 說明文件，確認支援或必要參數。 常見用途包括：
x-goog-request-params: name=projects/my-project/locations/us-central1&foo=bar |
變更記錄
- 2026 年 6 月：更新
x-goog-request-params的說明文件。 - 2021 年 11 月：發布
x-goog-request-params的說明文件。 - 2021 年 2 月：發布
quotaUser的說明文件。 - 2020 年 7 月：淘汰 OAuth 2.0 查詢參數。
- 2019 年 10 月：推出
X-Server-Timeout系統參數。 - 2017 年 10 月：推出
X-Goog-User-Project系統參數。