實作 OAuth 2.0 授權
YouTube Data 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 流程支援不存取使用者資訊的伺服器對伺服器互動。
不過,YouTube Data API 不支援這個流程。
Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate a
NoLinkedYouTubeAccount
error.
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-11-05 (世界標準時間)。
[null,null,["上次更新時間:2024-11-05 (世界標準時間)。"],[[["The YouTube Data API uses the OAuth 2.0 protocol to authorize access to private user data, which is initiated when a user attempts to use features requiring login."],["During authorization, the application requests specific scopes of access, defining which resources it can manage on behalf of the user."],["Upon user consent, Google issues a token to the application, which may be exchanged for an access token and a refresh token, allowing the application to act on the user's behalf."],["Google APIs support various OAuth 2.0 flows tailored to different application types, such as server-side web apps, JavaScript web apps, mobile and desktop apps, and limited-input devices."],["While OAuth 2.0 includes a service account flow, the YouTube Data API does not support this method, and using it will result in a `NoLinkedYouTubeAccount` error."]]],[]]