顯示 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,請按一下「全螢幕」圖示

執行方法

API Explorer 可讓您輸入必要參數、選用參數,以及 API 方法的要求主體 (如適用)。以許多 REST 方法 (例如清單方法) 來說,您只需要填入一兩個欄位,然後就能執行該方法。例如, Books API 的 books.volumes.list 方法只需使用查詢參數 (q) 即可列出書籍。如何試用 books.volumes.list 方法:

  1. 瀏覽至 books.volumes.list
  2. 如果「API Explorer」未顯示,請按一下 [立即試用!]
  3. q 欄位中,輸入 Hunger Games (不含引號或特殊字元)。
  4. 向下捲動,然後按一下 [Execute] (執行)
  5. (選用) Google 登入畫面會要求您選取 Google 帳戶。
  6. (選擇性) Google 授權對話方塊會詢問您是否允許「管理您的書籍」。按一下 [允許]。結果會顯示在 [執行] 按鈕的下方。

如果 APIs Explorer 顯示的結果為 200,則代表該方法成功執行。

排解 APIs Explorer 相關問題

您收到 401 或 403 錯誤

如果您在使用 APIs Explorer 執行方法時收到 401 或 403 錯誤,可能是下列其中一項原因所造成:

  • 您使用的授權類型不正確 (API 金鑰,而非 OAuth 2.0)。 請嘗試切換授權類型。
  • 您使用的是 OAuth 2.0,但範圍太小。請嘗試使用較大的範圍

授權對話方塊並未顯示

APIs Explorer 會透過彈出式視窗授予您私人資料的存取權。如果您的瀏覽器封鎖彈出式視窗,系統就不會顯示這個彈出式視窗,您也無法再授予權限。

如果您在授權對話方塊中按一下 [Allow] (允許),但系統未執行任何動作,請嘗試變更瀏覽器的彈出式視窗設定以啟用彈出式視窗。