GSP277

總覽

Google APIs Explorer 可讓您探索各種 Google API 方法，不必編寫程式碼。您可以透過這項工具執行下列操作：

• 快速瀏覽可用的 API 和版本。
• 查看各個 API 可用的方法、支援的參數，以及內嵌說明文件。
• 執行各種方法的要求，並即時查看回應。
• 發出經過驗證和授權的 API 呼叫。
• 搜尋所有服務、方法和近期要求，快速找到所需內容。

APIs Explorer 在發出要求時，會使用自己的 API 金鑰。使用 APIs Explorer 發出要求時，系統會顯示要求語法，其中包含標示為 {YOUR_API_KEY} 的預留位置。如要在應用程式中發出相同的要求，請將這個預留位置換成自己的 API 金鑰。

目標

• 建立 Cloud Storage bucket。
• 將圖片上傳至 Cloud Storage 並設為公開。
• 使用該圖片向 Vision API 提出要求。

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

1. 點選「Start Lab」按鈕。如果實驗室會產生費用，畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的臨時憑證
   • 完成這個實驗室所需的其他資訊 (如有)

2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，選取「在無痕視窗中開啟連結」。

   接著，實驗室會啟動相關資源，並開啟另一個分頁，顯示「登入」頁面。

   提示：您可以在不同的視窗中並排開啟分頁。

   注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

   {{{user_0.username | "Username"}}}

   您也可以在「Lab Details」窗格找到 Username。

4. 點選「下一步」。

5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

   {{{user_0.password | "Password"}}}

   您也可以在「Lab Details」窗格找到 Password。

6. 點選「下一步」。

   重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

7. 按過後續的所有頁面：

   • 接受條款及細則。
   • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
   • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要使用 Google Cloud 產品和服務，請點選「導覽選單」，或在「搜尋」欄位輸入服務或產品名稱。

工作 1：建立 Cloud Storage bucket

1. 前往 Cloud 控制台的「Cloud Storage」>「Bucket」頁面。
2. 按一下「建立 bucket」。
3. 為 bucket 指定專屬名稱。 bucket 命名空間全域通用並會公開顯示，因此請勿在 bucket 名稱加入機密資訊。例如：-bucket。
4. 點按「選取如何控制物件的存取權」。
5. 取消勾選「強制禁止公開存取這個 bucket」。
6. 選取「精細」存取權控管。
7. 點選「建立」。

測試已完成的工作

點選「Check my progress」，確認工作已完成。如果已成功建立 Cloud Storage bucket，您就會看見評估分數。

建立 Cloud Storage bucket。

工作 2：上傳圖片

您將透過 APIs Explorer 要求 Cloud Vision API 分析圖片。首先，將圖片新增至 bucket 進行分析。你可以使用自己的圖片，也可以將下方的圖片下載到電腦，並儲存為 demo-image.jpg。

1. 在 bucket 中，依序點選「上傳」>「上傳檔案」，然後選取儲存的 demo-image.jpg 檔案。

測試已完成的工作

點選「Check my progress」，確認工作已完成。如果已成功將圖片上傳至 Storage bucket，您就會看到評估分數。

將圖片上傳至 Storage bucket (demo-image.jpg)。

檔案上傳至 bucket 並列出後，請按照下列步驟公開分享圖片：

1. 點按圖片物件的三點溢位選單。
2. 在下拉式選單選取「編輯存取權」。
3. 在出現的重疊視窗，按一下「+ 新增項目」按鈕。
4. 為「allUsers」新增權限。
   • 在「實體」選取「公開」。
   • 在「名稱」輸入「allUsers」。
   • 在「存取權」選取「讀取者」。
5. 按一下「儲存」。

測試已完成的工作

點選「Check my progress」，確認工作已完成。如果已成功公開上傳的圖片，您就會看見評估分數。

將上傳的圖片設為可公開存取。

您應該會看到圖片現在已公開。您已準備好使用 APIs Explorer。

工作 3：向 Cloud Vision API 服務提出要求

1. 依序前往「導覽選單」>「API 和服務」。

2. 點選「+ 啟用 API 和服務」，搜尋「Cloud Vision」，然後從結果清單選取「Cloud Vision API」並點按。

3. 確認該 API 已啟用，如果沒有，請點選「啟用」。

4. 開啟「Cloud Vision - 試用這個 API」連結。

畫面上會開啟新分頁，並載入 APIs Explorer 頁面。

這時候就會進入 APIs Explorer 頁面。

注意：在下方章節中，我們將使用 Cloud Vision API 的 images.annotate 方法。您可以在 Cloud Vision API 參考資料中查看所有 API 版本和方法。

5. 在「要求主體」欄位的大括號內點按。
6. 系統會要求您選取屬性，請選擇「要求」。 這會產生下個步驟。
7. 在括號內點按，然後點選藍色加號圖示，選取 [Add Item]，並將屬性選擇「features」。
8. 在「features」中，點按大括號內部，然後點按藍色加號圖示並選取 [Add Item]，接著選取「type」，並在旁邊選取「LABEL_DETECTION」。
9. 在「features」區塊的結尾，應該會有藍色加號圖示，點選後即可選擇新增「image」，然後新增「source」和「imageUri」。
10. 在「imageUri」旁邊輸入 bucket 中圖片檔案的路徑。 路徑應如下所示：gs://MY_BUCKET/demo-image.jpg

完成後，「要求主體」欄位應如下所示：

11. 確認「憑證」專區中的「Google OAuth 2.0」和「API 金鑰」核取方塊皆已勾選。

注意：如要查看憑證常見問題，請點選「憑證」標題旁的問號圖示。

12. 在 APIs Explorer 控制台的右側面板，您可以看到使用 cURL、HTTP 和 JAVASCRIPT 的 Cloud Vision API 呼叫。

13. 接著點選「執行」。

14. 選取學生帳戶。

15. 在下一個畫面中，點選「允許」，授予 APIs Explorer 存取權。

Cloud Vision API 分析圖片的結果會顯示在右側面板下方。結果的頂端部分應如下所示：

工作 4：隨堂測驗

完成下列選擇題能加深您的印象，更清楚本實驗室介紹的概念，盡力回答即可。

恭喜！

您已向 Cloud Vision API 服務發出第一項 images.annotate 要求。

挑戰下一個實驗室

本實驗室屬於 Qwik Start 實驗室系列，旨在帶您一窺 Google Cloud 的眾多功能。在實驗室目錄搜尋「Qwik Start」，即可找到要進行的下一個實驗室！

後續步驟/瞭解詳情

• 如要瞭解如何使用 APIs Explorer，請前往常見問題頁面。
• 進一步瞭解 Cloud Vision API。

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法，讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程，並有隨選、線上和虛擬課程等選項，方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

關閉研究室

如果您已完成研究室，請按一下「End Lab」。您的帳戶和已用資源會從研究室平台中移除。

您可以為研究室的使用體驗評分。請選取合適的星級評等並提供意見，然後按一下「Submit」。

星級評等代表您的滿意程度：

• 1 星 = 非常不滿意
• 2 星 = 不滿意
• 3 星 = 普通
• 4 星 = 滿意
• 5 星 = 非常滿意

如果不想提供意見回饋，您可以直接關閉對話方塊。

如有任何想法、建議或指教，請透過「Support」分頁提交。

使用手冊上次更新日期：2024 年 11 月 4 日

實驗室上次測試日期：2024 年 11 月 4 日

Copyright 2026 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。