# Praktik terbaik YouTube Data

Population Cari video yang relevan, pilih trek kapsi dan proses unggahan saluran baru tanpa mengulangi pekerjaan.

Referensi boonical: https://flashdata.dev/ms/docs/guides/youtube-data-guide
Diulas: 2026-11-04 oleh FlashData

<a id="choose"></a>

## Mulailah dengan informasi yang sudah kau punya

Setiap sumber menjawab pertanyaan yang berbeda. Skip penemuan untuk video yang diketahui ID atau handle saluran, dan hanya memperkaya video yang diperlukan tugas Anda.

| Tugas Anda | Sumber | Keputusan |
| --- | --- | --- |
| Memerlukan video tentang topik | youtube_search | Mulai dengan lima kandidat, lalu pilih dengan relevansi. |
| Periksalah sebuah video yang dikenal | youtube_metadata | Bahasa wikipedia. |
| Ringkaskan atau petik perkara yang disebut | youtube_transcript / youtube_captions | Pilih bahasa dan trek otomatis atau manual. |
| Periksa unggahan saluran terbaru | youtube_channel | Aquimation mengembalikan IDs dengan IDs yang telah diproses. |

- [Cari video](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#discover)
- [Bekerja dengan video yang dikenal](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#metadata)
- [Monitorkan Saluran](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#channel)

<a id="setup"></a>

## Contoh permintaan dalam contoh permohonan

Simpan masing-masing badan JSON menggunakan nama file yang ditampilkan. Python menggunakan pembantu query.py di bawah ini; cURL dapat mengirimkan berkas yang sama. Guna kunci dengan izin sumber yang Anda butuhkan dan kredit yang tersedia. Setiap penyerahan adalah satu pertanyaan, terlepas dari jumlah video yang dikembalikan.

### Python

Python 3.10+. Permintaan pemasangan woaper sekali, simpan query.py di bawah, kemudian gunakan perintah di samping setiap permintaan. Keluaran yang telah ada digunakan kembali; masukan yang diubah memerlukan nama berkas keluaran baru.

#### Pasang

```bash
python -m pip install requests
```


### cURL

Bash. Megantikan REQUEST.json dan RESULT.json dengan nama berkas untuk contoh yang Anda pilih. Periksa hasil sebelum mengulangi permintaan; perintah ini menyelamatkan tubuh HTTP bahkan untuk kesalahan.

#### Serahkan permintaan JSON yang disimpan

```bash
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e RESULT.json || { echo 'Read RESULT.json first'; exit 1; }
curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-binary @REQUEST.json --output RESULT.json
)
```



<a id="authenticate"></a>

### Ketikkan kunci API anda

Gunakan kembali FLASHDATA_API_KEY dari terminal atau toko rahasia Anda. Jika tidak, masukkan kunci menggunakan satu tanda tangan tersembunyi di bawah. Tetap dalam proses menjalankan contoh-contoh ini.

#### Bash

##### Mematur kunci

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### Mematur kunci

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Kekunci API](https://flashdata.dev/app/api-keys)
- [Percubaan ejen dan pemautan akaun](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)

<a id="runner"></a>

### Simpan query.py untuk contoh Python

Buat query.py di folder kerja baru dan salin kode lengkap di bawahnya. Simpan berkas JSON permintaan dan skrip Python lainnya di folder ini, dan jalankan semua perintah dari sana.

#### query.py

```python
# query.py — submit a saved request once, then reuse its response.
import json
import os
import sys
from pathlib import Path
import requests

if len(sys.argv) != 3:
    raise SystemExit("Usage: python query.py REQUEST.json RESULT.json")
payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2])
marker = output.with_name(output.name + ".request.json")
receipt = output.with_name(output.name + ".http.json")
if marker.exists():
    if json.loads(marker.read_text()) != payload:
        raise SystemExit("Changed request: choose a new output filename.")
    if not output.exists() or not receipt.exists():
        raise SystemExit("Outcome unknown: check History before resubmitting.")
    saved = json.loads(receipt.read_text())
    if saved["status"] != 200 or json.loads(output.read_text(encoding="utf-8")).get("status") != "done":
        raise SystemExit(f"Saved request failed or incomplete; Retry-After: {saved['retry_after']}. Inspect {output}.")
    print(f"Read the saved {output}; no new query submitted.")
    raise SystemExit(0)
if output.exists():
    raise SystemExit("Output already exists. Read it or choose a new filename.")
key = os.environ["FLASHDATA_API_KEY"]
with marker.open("x", encoding="utf-8") as file:
    json.dump(payload, file)
response = requests.post("https://data.flashdata.dev/v1/queries/realtime",
                         headers={"X-API-Key": key}, json=payload,
                         timeout=70, allow_redirects=False)
output.write_text(response.text, encoding="utf-8")
receipt.write_text(json.dumps({"status": response.status_code,
                               "retry_after": response.headers.get("Retry-After")}), encoding="utf-8")
if response.status_code != 200:
    raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
if response.json().get("status") != "done":
    raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"saved": str(output), "usage": response.json().get("usage")}, indent=2))
```


<a id="discover"></a>

## Para calon akan mencari calon sebelum mengambil rinciannya

Filter video mengecualikan jenis hasil lain; subtitel mempersempit penemuan ke video dengan kapsi. Ini tidak memilih bahasa kapsi atau menjamin trek yang Anda butuhkan. Simpan sebagai discover-request.json.

### discover-request.json

```json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video",
      "subtitles": true
    }
  }
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py discover-request.json search.json
```


<a id="candidates"></a>

### Pilih berdasarkan relevansi, bukan ID pertama

Simpan candidates.py di samping query.py dan search.json, kemudian jalankan dari folder itu. Ia menyimpan urutan pencarian dan menghapus video ganda IDs. Periksa gelar, saluran dan durasi, kemudian salin ID yang dipilih ke dalam permintaan berikutnya. Daftar kosong adalah pencarian selesai tanpa kandidat.

#### candidates.py

```python
# candidates.py — read a saved response; no API calls.
import json
import re
from pathlib import Path

data = json.loads(Path("search.json").read_text(encoding="utf-8"))
if data.get("status") != "done":
    raise SystemExit("Search did not complete; inspect search.json.")
candidates, seen = [], set()
for item in (data.get("results") or [{}])[0].get("results", []):
    video_id = item.get("videoId", "")
    if not re.fullmatch(r"[A-Za-z0-9_-]{11}", video_id) or video_id in seen:
        continue
    seen.add(video_id)
    candidates.append({"videoId": video_id, "title": item.get("title"),
                       "channel": item.get("channel"), "duration": item.get("duration"),
                       "url": "https://www.youtube.com/watch?v=" + video_id})
Path("candidates.json").write_text(json.dumps(candidates, indent=2), encoding="utf-8")
print(json.dumps(candidates, indent=2))
```

#### Membaca pencarian yang disimpan

```bash
python candidates.py
```


<a id="extended"></a>

### Ekspansi hanya bila daftar pendek tidak mencukupi

Pencarian Standar Diagnosis mendukung max_results hingga 20. Untuk koleksi yang lebih luas, beralih ke youtube_search_extended, yang mendukung hingga 700 dan memiliki pricing terpisah. Contoh ini meminta 50; periksa apakah hasil pertama Anda berguna sebelum memperkaya mereka semua.

#### extended-request.json

```json
{
  "source": "youtube_search_extended",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 50,
    "filters": {
      "type": "video"
    }
  }
}
```

#### Jalankan sekali

```bash
python query.py extended-request.json extended.json
```

- [Kirimkan pencarian yang lebih panjang secara sinkron](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)
- [Perkaya ID yang dipilih](https://flashdata.dev/ms/docs/guides/enrich-youtube-videos/reference.md)

<a id="metadata"></a>

## Hanya ambil data meta yang diperlukan fitur Anda

Merebut sampel video_id dengan ID pilihan anda. Simpan format dan bab yang dilumpuhkan untuk kartu video sederhana atau cek bahasa kapsi. Memungkinkan include_chapters untuk garis luar, atau include_formats ketika memilih format media.

### metadata-request.json

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py metadata-request.json metadata.json
```

- [Medan respon Metadata](https://flashdata.dev/ms/docs/sources/youtube_metadata/reference.md#response)
- [Aliran kerja pengiriman media](https://flashdata.dev/ms/docs/guides/media-delivery-pipeline/reference.md)

<a id="tracks"></a>

### Periksa bahasa yang tersedia

Hasil Bacaan DVD[0].transcriptLanguages sebelum memilih kapsi. Format, bab dan bahasa adalah bidang pada objek video yang dikembalikan; catatan penggunaannya tergolong sebagai respon luar.

| Pemadapan | Gunalah untuk |
| --- | --- |
| language | Kode dari transcriptLanguages, seperti en atau zh-Hans. Daftar ini tidak membedakan trek manual dan otomatis. |
| auto: true | Sebuah lintasan yang telah dijana secara otomatis. |
| auto: false | Sebuah trek yang disediakan secara manual. Tidak ada kehancuran di antara dua tipe trek. |

#### Bacalah metadata.json · tidak ada pertanyaan

```bash
python -m json.tool metadata.json
```


<a id="captions"></a>

## Tak ada bahasa dan trek yang dipilih

Gunakan video_id yang sama dengan permintaan data meta Anda dan ubah bahasa dan auto untuk mencocokkan trek yang dipilih. youtube_transcript baku ke auto: true; youtube_captions baku ke auto: false. Kedua-duanya mengambil gambar yang sudah ada, bukan teks pidato.

### captions-request.json

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": "en",
    "auto": true
  }
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py captions-request.json captions.json
```

- [Parameter Kapsigon](https://flashdata.dev/ms/docs/sources/youtube_transcript/reference.md#parameters)
- [Bina ringkasan lengkap](https://flashdata.dev/ms/docs/guides/youtube-summary/reference.md)

<a id="citations"></a>

### Jaga timestamp dengan bukti

Simpan cite-segments.py di samping captions.json dan jalankan dari folder itu. Hasil penggunaan freak[0].segmen untuk kutipan: awal dan akhir adalah detik. Simpanan languageCode dan isAutoGenerated dengan teks. fullText berguna untuk membaca, tetapi tidak menggantikan waktu segmen. Jika trek yang dipilih hilang, rekam celah sebelum memutuskan apakah pertanyaan lain tidak berguna.

#### cite-segments.py

```python
import json
from pathlib import Path

response = json.loads(Path("captions.json").read_text(encoding="utf-8"))
if response.get("status") != "done":
    raise SystemExit("Inspect captions.json before continuing.")
track = (response.get("results") or [{}])[0]
if not track.get("segments"):
    raise SystemExit("No caption evidence was returned.")
for segment in track["segments"][:3]:
    url = f"https://www.youtube.com/watch?v={track['videoId']}&t={int(segment['start'])}s"
    print(segment["text"], url)
```

#### Tak ada panggilan API

```bash
python cite-segments.py
```


<a id="channel"></a>

## Hanya proses-proses proses-proses baru dari saluran yang dikenal

Takashi menggunakan handle saluran dan video_limitQ (1–100Q). results[0].video adalah daftar terbaru yang dikembalikan; videoCount adalah data meta saluran, bukan jumlah item yang dikembalikan. Pilihlah batas dan jadwal yang mencakup unggahan yang perlu diamati.

### channel-request.json

```json
{
  "source": "youtube_channel",
  "handle": "@TED",
  "params": {
    "video_limit": 10
  }
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py channel-request.json channel.json
```


<a id="channel-diff"></a>

### Buat antrian dan titik pemeriksaan selesai

Simpan channel-queue.py di samping query.py dan channel.json, dan jalankan dari folder itu. Lari tanpa argumen untuk membuat new-ids.json, kemudian memproses dan menyimpan bukti untuk IDs tersebut. Eligoza menjalankan --commit hanya setelah setiap antrian ID berhasil; kegagalan meninggalkan checkpoint tidak berubah. Use one directory per channel dan satu pekerja untuk contoh ini.

#### channel-queue.py

```python
# channel-queue.py — plan first; commit only after every queued video is processed.
import json
import re
import sys
from pathlib import Path

checkpoint = Path("processed-ids.json")
processed = set(json.loads(checkpoint.read_text()) if checkpoint.exists() else [])
queue = Path("new-ids.json")
if sys.argv[1:] == ["--commit"]:
    processed.update(json.loads(queue.read_text()))
    temporary = checkpoint.with_suffix(".tmp")
    temporary.write_text(json.dumps(sorted(processed)), encoding="utf-8")
    temporary.replace(checkpoint)
    queue.unlink()
    print("Checkpoint saved.")
elif sys.argv[1:]:
    raise SystemExit("Usage: python channel-queue.py [--commit]")
else:
    data = json.loads(Path("channel.json").read_text(encoding="utf-8"))
    if data.get("status") != "done":
        raise SystemExit("Channel query did not complete.")
    ids = dict.fromkeys(video.get("videoId", "") for video in
                        (data.get("results") or [{}])[0].get("videos", []))
    new = [value for value in ids if re.fullmatch(r"[A-Za-z0-9_-]{11}", value)
           and value not in processed]
    if queue.exists() and json.loads(queue.read_text()) != new:
        raise SystemExit("Finish the existing queue before replacing it.")
    queue.write_text(json.dumps(new, indent=2), encoding="utf-8")
    print(json.dumps(new, indent=2))
```

#### → proses → commit

```bash
python channel-queue.py
# Process every ID in new-ids.json and save its result first.
python channel-queue.py --commit
```

- [Jadwal dan penggunaan ulang kelayakan](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [Memkaya daftar video](https://flashdata.dev/ms/docs/guides/enrich-youtube-videos/reference.md)

<a id="channel-checkpoint"></a>

### Mulai pemeriksaan saluran segar sengaja

Pemberi pertanyaan menggunakan kembali jawaban yang disimpan. Untuk pemeriksaan berjadwal berikutnya, gunakan nama file hasil baru, periksa, kemudian salin yang selesai menanggapi channel.json untuk langkah antrian. Tetap jaga processed-ids.json antara berjalan. Daftar terbaru ini bukanlah ekspor saluran penuh atau aliran acara.

#### Periksa · selanjutnya pilih nama berkas baru

```bash
python query.py channel-request.json channel-next.json
```

#### Setelah konfirmasi status selesai

```bash
python -c "from shutil import copyfile; copyfile('channel-next.json', 'channel.json')"
```


<a id="suggestions"></a>

## Gunakan saran - saran untuk meningkatkan pertanyaan

Cadang saran kembali frasa dalam hasil[0], bukan catatan video. Melih frasa yang berguna dan buat permintaan youtube_search yang terpisah. Tetapkan bahasa dan wilayah untuk penonton Anda meneliti.

### suggestions-request.json

```json
{
  "source": "youtube_suggestions",
  "query": "battery recycling",
  "params": {
    "language": "en",
    "region": "US"
  }
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py suggestions-request.json suggestions.json
```


<a id="license"></a>

## Label lisensi Toko Kesentoran tanpa memperlakukan mereka sebagai izin

youtube_trainability mengembalikan label lisensi untuk sebuah video. diijinkan: ["all"] maps to Creative Commons; ["none"] juga meliputi data meta lisensi yang hilang. Tetap simpan video ID, respon sumber dan tanggal penerimaan kembali. Nama label ini tidak memberikan download, penggunaan kembali atau hak pelatihan.

### license-request.json

```json
{
  "source": "youtube_trainability",
  "video_id": "FUfGcZ092b0"
}
```

### Lepaskan sekali dengan query.py

```bash
python query.py license-request.json license.json
```


<a id="operations"></a>

## Membatasi pekerjaan untuk aplikasi dan agen

| KANTOR | Implementasi yang luar biasa |
| --- | --- |
| Kekayaan yang Dipilih sebelum diperkaya | Untuk tugas topik: satu pencarian, satu data meta video yang dipilih dan satu trek kapsi yang dipilih. EZOZE Paksakan anggaran panggilan dalam aplikasi Anda, dan harga setiap sumber secara terpisah. |
| Digunakan kembali oleh masukan sebenarnya | Metadata: video pilihan ID +. Kapsi: video ID + bahasa + trek. Saluran snapshots juga membutuhkan waktu penerimaan atau jalankan ID. |
| Hentikan bukti yang hilang | Jangan coba lagi hasil penemuan kosong atau beralih secara diam-diam trek kapsi. Azab kembali jadi pengguna atau workflow dapat memilih tindakan berikutnya. |
| Simpan penggunaan dan kerja gagal | Simpan penggunaan dengan respon yang sukses. 429Q, kehormatan Retry-After; setelah penyerahan yang tidak pasti, periksa History sebelum kueri berbayar lain. |

- [Realtime dan async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md)
- [Batch dan pukal](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md)
- [Galat dan retries](https://flashdata.dev/ms/docs/errors/reference.md#retries)
- [Keunggulan dan keseimbangan saat ini](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)
