YouTube Data API V3 配額說明

27次閱讀
尚無留言

每日配額

每個 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 列出影片分類

高消耗操作

  1. 搜尋功能 (search.list) 消耗最多資源(100 點)。避免頻繁使用搜尋功能,建議僅在必要時使用。
  2. 如果可以使用其他方法(例如儲存之前的結果),盡量避免重複的 search.list 請求。

如何最佳化配額使用

限制高消耗請求

  • 使用 search.list 時,設定具體的參數,如 regionCodemaxResultstype,減少不必要的結果。
  • 避免頻繁使用全局搜尋,嘗試在應用中緩存搜尋結果。

精簡回應資料 (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,分攤配額。

緩存和批量處理

  1. 緩存:將 API 回應緩存在應用中,避免對同一資源進行多次請求。
  2. 批量處理:一次請求獲取多個資源(例如,videos.list 可以同時查詢多個影片 ID)。

監控和調整

  1. 使用 Google Cloud 的配額儀表板來監控每日配額消耗。
  2. 定期審核應用的 API 使用模式,找到降低消耗的潛在方法。

如何查看每日配額使用情況

  1. 登錄 Google Cloud Console
  2. 選擇你的項目。
  3. 前往 API 和服務 > 配額
  4. 搜索 YouTube Data API V3,查看當前配額使用情況。

配額超過後的行為

如果超過每日配額,API 將返回 403 Forbidden 錯誤,並在錯誤回應中提供如下資訊:

{
  "error": {
    "code": 403,
    "message": "Quota Exceeded",
    "errors": [
      {
        "message": "Quota Exceeded",
        "domain": "youtube.quota",
        "reason": "quotaExceeded"
      }
    ]
  }
}

解決方法

  1. 等待第二天的配額重置。
  2. 減少 API 使用。
  3. 申請更高配額。

結論

善用緩存、限制高消耗請求、並監控配額使用情況是高效使用 YouTube Data API 的關鍵。如果你的應用有大量的使用需求,可以考慮申請額外配額或調整架構來分攤資源使用。

正文完
 0
評論(尚無留言)