如何申請 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

安全性限制設定

為了防止金鑰遭到冒用,建議務必完成下列兩項限制設定:

  1. 應用程式限制:選取「HTTP 參照位址 (網站)」,並新增您的網址網域(例如:https://www.yourdomain.com/*)。
  2. API 限制:選取「限制金鑰」,並在選單中勾選「YouTube Data API v3」。

結尾的 /* 是通用格式,代表該網域下的所有頁面皆可合法使用此金鑰。

5

配額消耗觀念說明

YouTube API 採點數累計制,每個專案每天有 10,000 單位的免費額度。以下是常見操作的點數消耗:

操作類型 消耗點數 說明
影片資訊讀取 (List) 1 單位 獲取影片標題、敘述等基礎資訊。
關鍵字搜尋 (Search) 100 單位 執行關鍵字檢索,消耗點數較高。
影片上傳 1,600 單位 點數負擔最重,需注意使用頻率。

配額將於每日特定時間自動重置。若網頁造訪量較大,建議搭配資料緩存機制,以維持服務穩定性。

留言

這個網誌中的熱門文章

慢連箋之領藥時間試算

影片自動循環或計時播放器