Mengimplementasikan Autentikasi OAuth 2.0
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
YouTube Live Streaming API mendukung protokol OAuth 2.0 untuk memberikan otorisasi akses ke data pribadi pengguna.
Daftar di bawah ini menjelaskan beberapa konsep inti OAuth 2.0:
-
Saat pengguna pertama kali mencoba menggunakan fungsi di aplikasi Anda yang mengharuskan pengguna login ke Google Account or YouTube account, aplikasi Anda akan memulai proses otorisasi OAuth 2.0.
-
Aplikasi Anda mengarahkan pengguna ke server otorisasi Google. Link ke halaman tersebut menentukan scope
akses yang diminta aplikasi Anda untuk akun pengguna. scope
menentukan resource yang dapat diambil, disisipkan, diperbarui, atau dihapus oleh aplikasi Anda saat bertindak sebagai pengguna yang diautentikasi.
-
Jika pengguna setuju untuk mengizinkan aplikasi Anda mengakses resource tersebut, Google akan menampilkan token ke aplikasi Anda. Bergantung pada jenis aplikasi Anda, aplikasi akan memvalidasi token atau menukarnya dengan jenis token yang berbeda.
Misalnya, aplikasi web sisi server menukar token yang ditampilkan dengan token akses dan token refresh. Token akses memungkinkan aplikasi mengotorisasi permintaan atas nama pengguna, dan token pembaruan memungkinkan aplikasi mengambil token akses baru ketika token akses asli berakhir masa berlakunya.
Penting: Untuk menggunakan Otorisasi OAuth 2.0, Anda harus mendapatkan kredensial otorisasi di Konsol API Google.
Untuk mengetahui detail selengkapnya, lihat Panduan Otorisasi OAuth 2.0.
Catatan: Channel harus disetujui untuk menggunakan fitur YouTube Live, yang memungkinkan pemilik channel untuk melakukan streaming konten live ke channel tersebut. Jika Anda mengirim permintaan
API atas nama pengguna terautentikasi yang channel-nya tidak diaktifkan atau tidak memenuhi syarat untuk melakukan streaming
konten live, API akan menampilkan error insufficientPermissions
.
Alur OAuth 2.0
Google API mendukung beberapa kasus penggunaan OAuth 2.0:
- Alur aplikasi web sisi server mendukung aplikasi web yang dapat menyimpan informasi persisten dengan aman.
- Alur aplikasi web JavaScript mendukung aplikasi JavaScript yang berjalan di browser.
- Alur aplikasi seluler dan desktop mendukung aplikasi yang diinstal di perangkat, seperti ponsel atau komputer.
- Alur TV dan perangkat input terbatas mendukung perangkat dengan kemampuan input terbatas, seperti konsol game dan kamera video.
- Alur OAuth 2.0 untuk alur akun layanan mendukung interaksi server ke server yang tidak mengakses informasi pengguna.
Namun, YouTube Live Streaming API tidak mendukung alur ini.
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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-11-05 UTC.
[null,null,["Terakhir diperbarui pada 2024-11-05 UTC."],[[["\u003cp\u003eThe YouTube Live Streaming API uses OAuth 2.0 for authorizing access to private user data, requiring an application to initiate the authorization process when a user attempts to use features needing a Google or YouTube account.\u003c/p\u003e\n"],["\u003cp\u003eDuring OAuth 2.0 authorization, the application directs the user to Google's authorization server, where the requested access scope is defined, specifying which resources the application can interact with.\u003c/p\u003e\n"],["\u003cp\u003eUpon user consent, Google returns a token to the application, which may be exchanged for an access token and a refresh token, enabling the application to make authorized requests and renew authorization when needed.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize OAuth 2.0 Authorization, you must obtain authorization credentials from the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eThe YouTube Live Streaming API supports several OAuth 2.0 flows, but does not support the Service Account flow.\u003c/p\u003e\n"]]],["The YouTube Live Streaming API utilizes OAuth 2.0 for authorizing access to user data. Applications initiate authorization, redirecting users to Google's server to define access scope. Upon user consent, Google issues a token; web apps exchange this for access and refresh tokens. Developers must obtain authorization credentials from the Google API Console. Different flows support various application types, but the service account flow is not compatible with the YouTube Live Streaming API. Channels must also be approved to enable live streaming.\n"],null,["# Implementing OAuth 2.0 Authentication\n\nThe YouTube Live Streaming API supports the [OAuth 2.0 protocol](http://oauth.net/2/) for authorizing access to private user data.\n\nThe following list explains some core OAuth 2.0 concepts:\n\n- When a user first attempts to use features in your application that requires the user to be logged in to a Google Account or YouTube account, your application initiates the OAuth 2.0 authorization process.\n\n- Your application directs the user to Google's authorization server. The link to that page specifies the **scope** of access that your application is requesting for the user's account. The **scope** specifies the resources that your application can retrieve, insert, update, or delete when acting as the authenticated user.\n\n- If the user consents to authorize your application to access those resources, Google returns a token to your application. Depending on your application's type, it either validates the token or exchanges it for a different type of token.\n\n For example, a server-side web application exchanges the returned token for an access token and a refresh token. The access token lets the application authorize requests on the user's behalf, and the refresh token lets the application retrieve a new access token when the original access token expires.\n\n**Important:** To use the OAuth 2.0 Authorization, you need to [obtain authorization credentials in the Google API Console](/youtube/v3/live/registering_an_application).\n\nFor more details, see the [OAuth 2.0 Authorization Guide](https://developers.google.com/identity/protocols/oauth2).\n\n**Note:** A channel must be approved to use the YouTube Live\nfeature, which enables the channel owner to stream live content to that channel. If you send API\nrequests on behalf of an authenticated user whose channel is not enabled or eligible to stream\nlive content, the API will return an `insufficientPermissions` error.\n\nOAuth 2.0 flows\n---------------\n\nGoogle APIs support several OAuth 2.0 use cases:\n\n- The [server-side web apps](/youtube/v3/live/guides/auth/server-side-web-apps) flow supports web applications that can securely store persistent information.\n- The [JavaScript web apps](/youtube/v3/live/guides/auth/client-side-web-apps) flow supports JavaScript applications running in a browser.\n- The [mobile and desktop apps](/youtube/v3/live/guides/auth/installed-apps) flow supports applications installed on a device, such as a phone or computer.\n- The [TVs and limited-input devices](/youtube/v3/live/guides/auth/devices) flow supports devices with limited input capabilities, such as game consoles and video cameras.\n- The OAuth 2.0 flow for service account flow supports server-to-server interactions that do not access user information. However, the YouTube Live Streaming API does not support this flow. 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."]]