顯示 APIs Explorer 並執行方法
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在大多數說明文件頁面中,畫面右側會顯示已展開的 APIs Explorer。如果 API Explorer 未顯示,請按一下 [Try it!] (試用!) 以顯示 API Explorer 的簡化版本。
如果參考資料說明文件頁面的右側並未顯示 [立即試用] ,表示 APIs Explorer 不支援這個方法。例如 API API Explorer 與需要服務帳戶的 API 不相容,因此這類 API 的說明文件頁面不會顯示該 API。
顯示展開的 APIs Explorer 版本
API Explorer 的展開版本包含 cURL、HTTP 以及其他可能的程式碼範例。如要顯示展開版本的 APIs Explorer,請按一下「全螢幕」圖示 fullscreen 。
注意: 如要執行程式碼範例,您必須產生並使用自己的授權憑證。如需建立專案及產生憑證的相關說明,請參閱您的 Google API 專用說明文件。
執行方法
API Explorer 可讓您輸入必要參數、選用參數,以及 API 方法的要求主體 (如適用)。以許多 REST 方法 (例如清單方法) 來說,您只需要填入一兩個欄位,然後就能執行該方法。例如, Books API 的 books.volumes.list
方法只需使用查詢參數 (q
) 即可列出書籍。如何試用 books.volumes.list
方法:
瀏覽至 books.volumes.list
。
如果「API Explorer」未顯示,請按一下 [立即試用!] 。
在 q
欄位中,輸入 Hunger Games (不含引號或特殊字元)。
向下捲動,然後按一下 [Execute] (執行) 。
(選用) Google 登入畫面會要求您選取 Google 帳戶。
(選擇性) Google 授權對話方塊會詢問您是否允許「管理您的書籍」。按一下 [允許] 。結果會顯示在 [執行] 按鈕的下方。
如果 APIs Explorer 顯示的結果為 200,則代表該方法成功執行。
注意: 在您允許授權畫面中提出授權要求之後,API Explorer 即有權提出其他要求,直到憑證到期為止。因此,後續所有方法呼叫都不會顯示授權畫面。如要進一步瞭解憑證,請參閱使用不同的憑證類型和範圍測試 。
排解 APIs Explorer 相關問題
您收到 401 或 403 錯誤
如果您在使用 APIs Explorer 執行方法時收到 401 或 403 錯誤,可能是下列其中一項原因所造成:
您使用的授權類型不正確 (API 金鑰,而非 OAuth 2.0)。
請嘗試切換授權類型。
您使用的是 OAuth 2.0,但範圍太小。請嘗試使用較大的範圍
授權對話方塊並未顯示
APIs Explorer 會透過彈出式視窗授予您私人資料的存取權。如果您的瀏覽器封鎖彈出式視窗,系統就不會顯示這個彈出式視窗,您也無法再授予權限。
如果您在授權對話方塊中按一下 [Allow] (允許) ,但系統未執行任何動作,請嘗試變更瀏覽器的彈出式視窗設定以啟用彈出式視窗。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2022-04-27 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2022-04-27 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2022-04-27 (世界標準時間)。"]]