YouTube Reporting API 和 YouTube Analytics API 支援 OAuth 2.0 通訊協定,可授權存取私人使用者資料。下列清單說明了一些核心 OAuth 2.0 概念:
-
當使用者首次嘗試使用需要登入 Google Account or YouTube account 才能使用的應用程式功能時,應用程式會啟動 OAuth 2.0 授權程序。
-
應用程式會將使用者導向 Google 的授權伺服器。該頁面的連結會指定應用程式針對使用者帳戶要求的存取權
scope
。scope
會指定應用程式以已驗證使用者身分時,擷取、插入、更新或刪除的資源。 -
如果使用者同意授權您的應用程式存取這些資源,Google 就會將權杖傳回您的應用程式。視應用程式類型而定,應用程式會驗證權杖,或將權杖換成其他類型的權杖。
舉例來說,伺服器端網頁應用程式會將傳回的權杖換成存取權杖和更新權杖。存取權杖可讓應用程式代表使用者授權要求,而更新權杖可讓應用程式在原始存取權杖過期時擷取新的存取權杖。
重要事項:如要使用 OAuth 2.0 授權,您必須在 Google API 控制台中取得授權憑證。
詳情請參閱 OAuth 2.0 授權指南。
OAuth 2.0 流程
Google API 支援多種 OAuth 2.0 使用案例:
- 伺服器端網頁應用程式流程支援可安全儲存持續性資訊的網頁應用程式。
- JavaScript 網頁應用程式流程支援在瀏覽器中執行的 JavaScript 應用程式。
- 行動和電腦應用程式流程支援在裝置 (例如手機或電腦) 上安裝的應用程式。
- 適用於電視和有限輸入裝置的 OAuth 2.0 流程支援輸入功能有限的裝置,例如遊戲主機和影片攝影機。The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
- 服務帳戶的 OAuth 2.0 流程支援不存取使用者資訊的伺服器對伺服器互動。 不過,YouTube Reporting API 和 YouTube Analytics API 不支援這個流程。 Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.
找出存取權範圍
範圍可讓應用程式僅要求存取其需要的資源,也能讓使用者控制對應用程式授予的存取量。因此,要求的範圍數量與取得使用者同意聲明的可能性可能存在相反關係。
開始實作 OAuth 2.0 授權之前,建議您找出應用程式需要權限存取的範圍。
YouTube Analytics API 使用下列範圍:
範圍 | |
---|---|
https://www.googleapis.com/auth/youtube | 管理您的 YouTube 帳戶 |
https://www.googleapis.com/auth/youtube.readonly | 查看您的 YouTube 帳戶 |
https://www.googleapis.com/auth/youtubepartner | 查看及管理您在 YouTube 上的元素和相關內容 |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | 查看您 YouTube 內容的金額和非金額 YouTube 數據分析報表 |
https://www.googleapis.com/auth/yt-analytics.readonly | 查看您 YouTube 內容的 YouTube 數據分析報表 |
YouTube Reporting API 採用的範圍如下:
範圍 | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | 查看您 YouTube 內容的金額和非金額 YouTube 數據分析報表 |
https://www.googleapis.com/auth/yt-analytics.readonly | 查看您 YouTube 內容的 YouTube 數據分析報表 |
「OAuth 2.0 API 範圍」文件包含您可能用於存取 Google API 的範圍完整清單。