如何申請 YouTube API Key ( API 金鑰 ) ?
要在網站上呈現 YouTube 影音資訊,需要先在 Google Cloud 平台完成 API 服務的申請與設定,操作流程如下:
1
建立 Google Cloud 專案
Google Cloud 所有的 API 操作都必須依附在專案之下,請先依下列路徑完成專案初始化:
[ 1 ] 登入 Google Cloud Console (https://console.cloud.google.com/)
[ 2 ] 點擊左上方專案名稱 ➔ 跳出視窗點選右上角 [ 新增專案 ]
[ 3 ] 輸入您的專案名稱 ➔ 按下 [ 建立 ]
[ 4 ] 待右上方通知進度跑完 ➔ 點擊 [ 選取專案 ] 確保切換至正確環境
2
啟用 API 服務
專案建立後,必須手動開啟 YouTube 相關的功能連結:
[ 1 ] 點擊左側導覽選單 ➔ [ API 和服務 ] ➔ [ 程式庫 ]
[ 2 ] 搜尋關鍵字:YouTube Data API v3
[ 3 ] 點擊該項目進入 ➔ 點擊藍色按鈕 [ 啟用 ]
3
建立認證金鑰 (路徑選擇)
啟用服務後,系統通常會停留在 API 詳情頁面。此時可從以下兩條路徑可擇一 操作即可:
路徑 A:手動建立模式
若您直接點擊左側選單的 [憑證] ➔ 點擊上方 [+建立憑證] ➔ 選擇 [API 金鑰]:
系統會立即產生一組金鑰。請注意在設定名稱的頁面中:
注意:畫面下方的「透過服務帳戶驗證 API 呼叫」請務必保持空白,不要勾選。勾選後會改變驗證機制,導致一般網頁呼叫失敗。
路徑 B:系統引導模式
若您是點擊頁面右側提示的 [建立憑證] 按鈕,系統會以問卷方式引導您:
- 您目前使用的是哪個 API? ➔ 請選取「YouTube Data API v3」。
- 您需要存取什麼資料? ➔ 請務必選取「公開資料 (Public data)」。
※ 選擇公開資料後,後續只需使用 API 金鑰即可,不需處理複雜的 OAuth 驗證程序。
4
安全性限制設定
為了防止金鑰遭到冒用,建議務必完成下列兩項限制設定:
- 應用程式限制:選取「HTTP 參照位址 (網站)」,並新增您的網址網域(例如:
https://www.yourdomain.com/*)。 - API 限制:選取「限制金鑰」,並在選單中勾選「YouTube Data API v3」。
結尾的 /* 是通用格式,代表該網域下的所有頁面皆可合法使用此金鑰。
5
配額消耗觀念說明
YouTube API 採點數累計制,每個專案每天有 10,000 單位的免費額度。以下是常見操作的點數消耗:
| 操作類型 | 消耗點數 | 說明 |
|---|---|---|
| 影片資訊讀取 (List) | 1 單位 | 獲取影片標題、敘述等基礎資訊。 |
| 關鍵字搜尋 (Search) | 100 單位 | 執行關鍵字檢索,消耗點數較高。 |
| 影片上傳 | 1,600 單位 | 點數負擔最重,需注意使用頻率。 |
配額將於每日特定時間自動重置。若網頁造訪量較大,建議搭配資料緩存機制,以維持服務穩定性。
留言
張貼留言