標準查詢參數

下表是適用於所有 Google Cloud Billing API 作業的查詢參數。

注意事項 (關於 API 金鑰和驗證憑證):

  1. 每個要求都需要 key 參數,除非要求中包含 OAuth 2.0 憑證。
  2. 每當您發出需要 OAuth 範圍的要求時,必須傳送授權憑證。OAuth 2.0 是唯一支援的授權通訊協定。
  3. 每次要求時都可使用下列其中一種方式提供 OAuth 2.0 憑證:
    • 使用 access_token 查詢參數,例如:?access_token=oauth2-token
    • 使用 HTTP Authorization 標頭,例如:Authorization: Bearer oauth2-token

除非另外註明,否則所有參數皆為選用。

參數 意義 附註
access_token 目前使用者的 OAuth 2.0 憑證。
callback 回呼函式。
  • 負責處理回應的 JavaScript 回呼函式名稱。
  • 用於 JavaScript JSON-P 要求。
key API 金鑰。(必要*)
  • *除非您提供 OAuth 2.0 憑證,否則此為必要參數。
  • 您的 API 金鑰可識別專案並為您提供 API 存取權、配額和報表。
  • 您可以透過 Google Cloud Platform 主控台取得專案的 API 金鑰。
prettyPrint

傳回包含縮排和分行符號的回應。

  • 如果為 true,則以使用者能夠理解的格式傳送回應。
  • 預設值:true
  • 當這個值是 false 時,可以縮減回應的酬載大小,在某些環境中或許可提升效能。
quotaUser userIp 的替代參數。
  • 讓您在使用者 IP 位址不明的情況下,也能透過伺服器端的應用程式強制執行每個使用者的配額限制。舉例來說,如果是代表使用者在 App Engine 上執行 cron 工作的應用程式,就可能發生這種情形。
  • 您可以選擇用來識別使用者的任意字串,但上限為 40 個字元。
  • 如果兩者都提供就會覆寫 userIp
  • 進一步瞭解如何限制 API 用量
userIp 進行 API 呼叫時,受呼叫的使用者 IP 位址。
  • 讓您在透過伺服器端應用程式呼叫 API 時,強制執行每個使用者的配額限制。
  • 進一步瞭解如何限制 API 用量

本頁內容對您是否有任何幫助?請提供意見: