Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Panduan memulai ini menjelaskan cara menyiapkan aplikasi command line Python sederhana yang membuat permintaan ke YouTube Data API. Panduan memulai ini menjelaskan cara membuat dua permintaan API:
Anda akan menggunakan kunci API, yang mengidentifikasi aplikasi Anda, untuk mengambil informasi tentang channel YouTube GoogleDevelopers.
Anda akan menggunakan ID klien OAuth 2.0 untuk mengirimkan permintaan yang diizinkan yang mengambil informasi tentang channel YouTube Anda sendiri.
Prasyarat
Untuk menjalankan panduan memulai ini, Anda memerlukan:
Python 2.7 atau Python 3.5+
Alat pengelolaan paket pip
Library Klien Google API untuk Python:
pipinstall--upgradegoogle-api-python-client
Library google-auth-oauthlib dan google-auth-httplib2 untuk otorisasi pengguna.
Buat kunci API
Anda akan menggunakan kunci API untuk membuat permintaan API yang tidak memerlukan otorisasi pengguna. Misalnya, Anda tidak memerlukan otorisasi pengguna untuk mengambil informasi tentang channel YouTube publik.
Buat client ID OAuth 2.0
Tetapkan jenis aplikasi ke Lainnya. Anda harus menggunakan kredensial OAuth 2.0 untuk permintaan yang memerlukan otorisasi pengguna. Misalnya, Anda memerlukan otorisasi pengguna untuk mengambil informasi tentang channel YouTube pengguna yang saat ini diautentikasi.
Download file JSON yang berisi kredensial OAuth 2.0 Anda. File
memiliki nama seperti client_secret_CLIENTID.json, dengan CLIENTID adalah
ID klien untuk project Anda.
Langkah 2: Siapkan dan jalankan contoh
Gunakan widget APIs Explorer di panel samping untuk mendapatkan contoh kode guna mengambil informasi tentang channel YouTube GoogleDevelopers. Permintaan ini menggunakan kunci API untuk mengidentifikasi aplikasi Anda, dan tidak memerlukan otorisasi pengguna atau izin khusus apa pun dari pengguna yang menjalankan contoh.
Di halaman tersebut, bagian "Kasus penggunaan umum" berisi tabel yang menjelaskan beberapa cara umum penggunaan metode ini. Listingan pertama dalam tabel
adalah untuk mencantumkan hasil menurut ID channel.
Klik simbol kode untuk listingan pertama guna membuka dan mengisi
API Explorer layar penuh.
Sisi kiri APIs Explorer layar penuh menampilkan hal berikut:
Di bawah header Parameter permintaan, ada daftar parameter yang didukung metode ini. Nilai parameter part dan id harus ditetapkan. Nilai parameter id, UC_x5XG1OV2P6uZZ5FSM9Ttw, adalah
ID untuk channel YouTube GoogleDevelopers.
Di bawah parameter, ada bagian bernama Kredensial. Menu pull-down di bagian tersebut akan menampilkan nilai API key. APIs Explorer menggunakan kredensial demo secara default untuk mempermudah memulai. Namun, Anda akan menggunakan kunci API Anda sendiri untuk menjalankan sampel secara lokal.
Sisi kanan fullscreen APIs Explorer menampilkan tab dengan contoh kode dalam berbagai bahasa. Pilih tab Python.
Salin contoh kode dan simpan dalam file bernama
example.py.
Di contoh yang Anda download, temukan string YOUR_API_KEY dan ganti dengan kunci API yang Anda buat di langkah 1 panduan memulai ini.
Jalankan contoh dari command line. Di direktori kerja Anda, jalankan:
python example.py
Contoh harus menjalankan permintaan dan mencetak respons ke STDOUT.
Langkah 3: Jalankan permintaan yang diizinkan
Pada langkah ini, Anda akan mengubah contoh kode sehingga alih-alih mengambil
informasi tentang channel YouTube GoogleDevelopers, kode tersebut mengambil informasi
tentang channel YouTube Anda. Permintaan ini memerlukan otorisasi pengguna.
Kembali ke dokumentasi untuk metode
channels.list API.
Di bagian "Kasus penggunaan umum", klik simbol kode untuk listingan ketiga dalam tabel. Kasus penggunaan tersebut adalah memanggil metode list untuk "my
channel".
Sekali lagi, di sisi kiri fullscreen APIs Explorer, Anda akan melihat
daftar parameter yang diikuti dengan bagian Credentials. Namun, ada dua perubahan dari contoh tempat Anda mengambil informasi tentang channel GoogleDevelopers:
Di bagian parameter, bukan nilai parameter id yang ditetapkan, nilai parameter mine harus ditetapkan ke true. Hal ini menginstruksikan server API untuk mengambil informasi tentang channel pengguna yang saat ini diautentikasi.
Di bagian Credentials, menu pull-down harus memilih opsi untuk Google OAuth 2.0.
Selain itu, jika Anda mengklik link Tampilkan cakupan, cakupan
https://www.googleapis.com/auth/youtube.readonly harus dicentang.
Seperti contoh sebelumnya, pilih tab Python,
salin contoh kode, lalu simpan ke example.py.
Dalam kode, temukan string YOUR_CLIENT_SECRET_FILE.json dan ganti dengan lokasi file rahasia klien yang Anda download di langkah 1 panduan memulai ini.
Jalankan contoh dari command line. Di direktori kerja Anda, jalankan:
python example.py
Salin URL dari konsol dan buka di browser Anda.
Jika belum login ke Akun Google, Anda akan diminta untuk login. Jika login ke beberapa akun Google, Anda akan diminta untuk memilih satu akun yang akan digunakan untuk otorisasi.
Klik tombol untuk memberikan akses aplikasi Anda ke cakupan yang ditentukan dalam contoh kode Anda.
Salin kode otorisasi dari browser dan tempelkan ke terminal Anda. Kemudian, Anda dapat menutup tab browser yang digunakan untuk alur autentikasi.
[null,null,["Terakhir diperbarui pada 2025-08-21 UTC."],[[["\u003cp\u003eThis guide walks through setting up a Python command-line application to interact with the YouTube Data API.\u003c/p\u003e\n"],["\u003cp\u003eYou'll learn how to use an API key to retrieve public information, such as details about the GoogleDevelopers YouTube channel.\u003c/p\u003e\n"],["\u003cp\u003eThe guide also covers using OAuth 2.0 for authorized requests, enabling you to retrieve information about your own YouTube channel.\u003c/p\u003e\n"],["\u003cp\u003ePrerequisites include Python 2.7 or 3.5+, \u003ccode\u003epip\u003c/code\u003e, the Google APIs Client Library for Python, and the \u003ccode\u003egoogle-auth-oauthlib\u003c/code\u003e and \u003ccode\u003egoogle-auth-httplib2\u003c/code\u003e libraries.\u003c/p\u003e\n"],["\u003cp\u003eThe process includes setting up your project in the API Console, creating an API key and OAuth 2.0 credentials, and running sample code to make API requests.\u003c/p\u003e\n"]]],["This guide demonstrates using the YouTube Data API with Python. It covers two core actions: retrieving channel information using an API key and making an authorized request for your own channel data using OAuth 2.0. Key steps include setting up a project in the API Console, enabling the YouTube Data API, creating an API key and OAuth 2.0 credentials. The guide provides instructions for running code samples that retrieve information, replacing placeholder strings with personal credentials, and completing user authorization in the browser.\n"],null,["# Python Quickstart\n\nThis quickstart guide explains how to set up a simple, Python\ncommand-line application that makes requests to the YouTube Data API. This\nquickstart actually explains how to make two API requests:\n\n1. You will use an API key, which identifies your application, to retrieve information about the GoogleDevelopers YouTube channel.\n2. You will use an OAuth 2.0 client ID to submit an *authorized* request that retrieves information about your own YouTube channel.\n\n| **Note:** More generally, you can follow the instructions for the first example for any use case that uses an API key or the instructions for the second example for any use case that requires authorization using OAuth 2.0. See the [use cases and code samples tool](/youtube/v3/code_samples/code_snippets) for more examples.\n\nPrerequisites\n-------------\n\nTo run this quickstart, you'll need:\n\n- Python 2.7 or Python 3.5+\n\n- The `pip` package management tool\n\n- The Google APIs Client Library for Python:\n\n pip install --upgrade google-api-python-client\n\n- The `google-auth-oauthlib` and `google-auth-httplib2` libraries for user\n authorization.\n\n pip install --upgrade google-auth-oauthlib google-auth-httplib2\n\nStep 1: Set up your project and credentials\n-------------------------------------------\n\nCreate or select a project in the [API Console](https://console.cloud.google.com/). Complete the following tasks in the API Console for your project:\n\n1. In the [library panel](https://console.developers.google.com/apis/library),\n search for the YouTube Data API v3. Click into the listing for that API and\n make sure the API is enabled for your project.\n\n2. In the [credentials\n panel](https://console.developers.google.com/apis/credentials),\n create two credentials:\n\n 1. **Create an API key**\n You will use the API key to make API requests that do\n not require user authorization. For example, you do not need user\n authorization to retrieve information about a public YouTube channel.\n\n 2. **Create an OAuth 2.0 client ID**\n\n Set the application type to **Other**. You need to use OAuth 2.0\n credentials for requests that require user authorization. For example,\n you need user authorization to retrieve information about the currently\n authenticated user's YouTube channel.\n\n Download the JSON file that contains your OAuth 2.0 credentials. The\n file has a name like `client_secret_CLIENTID.json`, where `CLIENTID` is\n the client ID for your project.\n\nStep 2: Set up and run the sample\n---------------------------------\n\nUse the APIs Explorer widget in the side panel to obtain sample code for\nretrieving information about the GoogleDevelopers YouTube channel. This request\nuses an API key to identify your application, and it does not require user\nauthorization or any special permissions from the user running the sample.\n\n1. Open the documentation for the API's [channels.list](/youtube/v3/docs/channels/list) method.\n2. On that page, the \"Common use cases\" section contains a table that explains\n several common ways that the method is used. The first listing in the table\n is for listing results by channel ID.\n\n Click the code symbol for the first listing to open and populate the\n fullscreen APIs Explorer.\n\n3. The left side of the fullscreen APIs Explorer shows the following:\n\n 1. Below the **Request parameters** header, there is a list of parameters\n that the method supports. The `part` and `id` parameter values should\n be set. The `id` parameter value, `UC_x5XG1OV2P6uZZ5FSM9Ttw`, is the\n ID for the GoogleDevelopers YouTube channel.\n\n 2. Below the parameters, there is a section named **Credentials** . The\n pulldown menu in that section should display the value **API key**. The\n APIs Explorer uses demo credentials by default to make it easier to get\n started. But you'll use your own API key to run the sample locally.\n\n4. The right side of the fullscreen APIs Explorer shows tabs with code samples\n in different languages. Select the **Python** tab.\n\n5. Copy the code sample and save it in a file named\n `example.py`.\n\n6. In the sample that you downloaded, find the `YOUR_API_KEY` string and\n replace that with the API key that you created in step 1 of this quickstart.\n\n7. Run the sample from the command line. In your working directory, run:\n\n\n `python example.py`\n8. The sample should execute the request and print the response to `STDOUT`.\n\nStep 3: Run an authorized request\n---------------------------------\n\nIn this step, you'll modify your code sample so that instead of retrieving\ninformation about the GoogleDevelopers YouTube channel, it retrieves information\nabout *your* YouTube channel. This request does require user authorization.\n\n1. Go back to the documentation for the API's\n [channels.list](/youtube/v3/docs/channels/list) method.\n\n2. In the \"Common use cases\" section, click the code symbol for the third\n listing in the table. That use case is to call the `list` method for \"my\n channel.\"\n\n3. Again, in the left side of the fullscreen APIs Explorer, you will see a\n list of parameters followed by the **Credentials** section. However, there\n are two changes from the example where you retrieved information about the\n GoogleDevelopers channel:\n\n 1. In the parameters section, instead of the `id` parameter value being\n set, the `mine` parameter value should be set to `true`. This instructs\n the API server to retrieve information about the currently authenticated\n user's channel.\n\n 2. In the **Credentials** section, the pulldown menu should select the\n option for **Google OAuth 2.0**.\n\n In addition, if you click the **Show scopes** link, the\n **https://www.googleapis.com/auth/youtube.readonly** scope should be\n checked.\n\n4. As with the previous example, select the **Python** tab,\n copy the code sample, and save it to `example.py`.\n\n\n In the code, find the `YOUR_CLIENT_SECRET_FILE.json` string and replace\n it with the location of the client secret file you downloaded in step 1\n of this quickstart.\n5. Run the sample from the command line. In your working directory, run:\n\n\n `python example.py`\n6. \u003cbr /\u003e\n\n\n Copy the URL from the console and open it in your browser.\n\n If you are not already logged into your Google account, you will be\n prompted to log in. If you are logged into multiple Google accounts, you\n will be asked to select one account to use for the authorization.\n7. Click the button to grant your application access to the scopes specified in\n your code sample.\n\n8. \u003cbr /\u003e\n\n\n Copy the auth code from the browser and paste it into your terminal. You can\n then close the browser tab used for the auth flow.\n\n The API response should again be printed to `STDOUT`.\n\nFurther reading\n---------------\n\n- [Google Developers Console help documentation](/console/help/new)\n- [Google APIs Client Library for Python documentation](/api-client-library/python)\n- [YouTube Data API PyDoc documentation](https://developers.google.com/resources/api-libraries/documentation/youtube/v3/python/latest/)\n- [YouTube Data API reference documentation](/youtube/v3/docs)"]]
