每日配額
每個 Google Cloud 項目每天有 10,000 點的免費配額。如果需要更多配額,可以向 Google Cloud 支持申請(需要說明用例並可能涉及費用)。
常見 API 操作的配額消耗
以下是 YouTube Data API V3 的一些常見操作及其配額消耗:
search.list |
100 | 搜尋影片或頻道 |
videos.list |
1 | 取得影片詳細資訊 |
channels.list |
1 | 取得頻道詳細資訊 |
playlists.list |
1 | 取得播放清單資訊 |
playlistItems.list |
1 | 列出清單項目 |
subscriptions.list |
1 | 列出訂閱頻道 |
comments.list |
1 | 取得評論 |
commentThreads.list |
1 | 取得評論串 |
videoCategories.list |
1 | 列出影片分類 |
高消耗操作
- 搜尋功能 (
search.list
) 消耗最多資源(100 點)。避免頻繁使用搜尋功能,建議僅在必要時使用。 - 如果可以使用其他方法(例如儲存之前的結果),盡量避免重複的
search.list
請求。
如何最佳化配額使用
限制高消耗請求
- 使用
search.list
時,設定具體的參數,如regionCode
、maxResults
和type
,減少不必要的結果。 - 避免頻繁使用全局搜尋,嘗試在應用中緩存搜尋結果。
精簡回應資料 (part
參數)
每次 API 請求都可以通過 part
指定需要的字段。例如:
GET https://www.googleapis.com/youtube/v3/videos?part=snippet&id=abc123&key=API_KEY
如果只需要標題和描述,可以僅請求 snippet
而非所有字段。
使用多個 API Key
如果你的應用需要頻繁訪問 API,可以在 Google Cloud Console 中建立多個項目,分別生成 API Key,分攤配額。
緩存和批量處理
- 緩存:將 API 回應緩存在應用中,避免對同一資源進行多次請求。
- 批量處理:一次請求獲取多個資源(例如,
videos.list
可以同時查詢多個影片 ID)。
監控和調整
- 使用 Google Cloud 的配額儀表板來監控每日配額消耗。
- 定期審核應用的 API 使用模式,找到降低消耗的潛在方法。
如何查看每日配額使用情況
- 登錄 Google Cloud Console。
- 選擇你的項目。
- 前往 API 和服務 > 配額。
- 搜索 YouTube Data API V3,查看當前配額使用情況。
配額超過後的行為
如果超過每日配額,API 將返回 403 Forbidden 錯誤,並在錯誤回應中提供如下資訊:
{
"error": {
"code": 403,
"message": "Quota Exceeded",
"errors": [
{
"message": "Quota Exceeded",
"domain": "youtube.quota",
"reason": "quotaExceeded"
}
]
}
}
解決方法
- 等待第二天的配額重置。
- 減少 API 使用。
- 申請更高配額。
結論
善用緩存、限制高消耗請求、並監控配額使用情況是高效使用 YouTube Data API 的關鍵。如果你的應用有大量的使用需求,可以考慮申請額外配額或調整架構來分攤資源使用。
正文完