# YouTube Data en iyi uygulamalar

İlgili videoları bulun, arama parçaları seçin ve yeni kanal yüklemelerini tekrarlamadan yapın.

Canonical referans: https://flashdata.dev/tr/docs/guides/youtube-data-guide
İnceleme: 2026-11-04 Tarafından FlashData

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

## Zaten sahip olduğunuz bilgilerle başlayın

Her kaynak farklı bir soruyu yanıtlar. Bilinen bir video ID veya kanal işlerinin keşfine gelin ve yalnızca görev ihtiyaçlarınızdaki videoları zenginleştirin.

| Senin görevin | Source Source Source | Karar Karar Kararı |
| --- | --- | --- |
| Bir konu hakkında videolar bulun | youtube_search | Beş adayla başlayın, sonra da ilgiyle seçin. |
| Bilinen bir video | youtube_metadata | Başlık alın, kanal, süresi ve satır dilleri. |
| Summarize ya da söyleneni sil | youtube_transcript / youtube_captions | Bir dil ve otomatik veya manuel bir takip seçin. |
| Check son kanal yüklemeleri | youtube_channel | Karşılaştırma IDs'u işlediğiniz IDs ile geri döndü. |

- [videoları bulun](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#discover)
- [Bilinen bir video ile çalışmak](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#metadata)
- [Bir kanal izlemek](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#channel)

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

## İstek örneklerini çalıştırın

Her JSON bedenini görüntülenen dosya adını kullanarak kurtarın. Python aşağıdaki query.py yardımcısını kullanır; cURL aynı dosyayı sunabilir. İhtiyacınız ve mevcut kredilere ihtiyacınız olan kaynak izni ile bir anahtar kullanın. Her bir teslim, geri dönen video sayısına bakılmaksızın bir sorgudur.

### Python

Python 3.10+. Bir kez yükleme istekleri, query.py'u aşağıda kurtar, sonra her isteğin yanında komut kullanın. Mevcut çıkışlar yeniden kullanılabilir; girdi değişti yeni bir çıkış dosyası adı gerektirir.

#### Yükle

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


### cURL

Bash. REQUEST.json ve RESULT.json'u seçtiğiniz örnek için dosya isimleri ile değiştirin. Bir isteği tekrarlamadan önce sonucu kontrol edin; bu komut HTTP bedenini bir hata için bile kurtarır.

#### Kurtarılan JSON isteği

```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>

### API anahtarını ayarlayın

FLASHDATA_API_KEY'u terminalinizden veya gizli mağazanızdan kullanın. Aksi takdirde aşağıda saklı bir tane kullanarak anahtara girin. Bu örnekleri işleyen süreçte tutun.

#### Bash

##### Anahtarı ayarlayın

```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

##### Anahtarı ayarlayın

```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
```


- [API anahtarları](https://flashdata.dev/app/api-keys)
- [Ajan denemesi ve hesap bağlama](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)

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

### query.py örneklerini Python örneklerini kurtarın

query.py'u yeni bir çalışma klasöründe oluşturun ve aşağıdaki tam kodu kopyalayın. JSON dosyaları ve diğer Python senaryolarını bu klasörde kurtarın ve oradan tüm komutları çalıştırın.

#### 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>

## Ayrıntılar getirmeden önce adaylar bulun

Video filtre diğer sonuç tiplerini dışlar; alt başlıklar, altyazılarla videolar için dar keşifler. Bir komut dili seçmez veya ihtiyacınız olan pisti garanti etmez. discover-request.json olarak tasarruf edin.

### discover-request.json

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

### query.py ile bir kez gönder

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


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

### İlgili olarak seçin, ilk ID

Save Kaydet candidates.py yanında başka bir yerde query.py Ve ve search.jsonSonra o klasörden çalıştırın. Arama siparişi tutar ve tekrarlanan videoyu IDs'u kaldırır. Müfettiş başlıkları, kanallar ve süre sonra bir sonraki istekte seçilmiş ID'yu kopyalayın. Boş bir liste hiçbir adayla tamamlanmış bir aramadır.

#### 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))
```

#### Kurtarılan aramayı okuyun

```bash
python candidates.py
```


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

### Sadece kısa liste yetersiz olduğunda genişletin

Standart Arama destek destekler max_results yukarı yukarı 20. Daha geniş bir koleksiyon için, geçiş yapın youtube_search_extendedAma bu, onu destekliyor 700 Ve ayrı fiyatlandırmaya sahiptir. Bu örnek 50 için soruyor; ilk sonuçlarınızın hepsini zenginleştirmeden önce yararlı olup olmadığını kontrol edin.

#### extended-request.json

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

#### Bir kez çalıştırın

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

- [Daha uzun bir arama asynchronously](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)
- [En zengin seçilmiş IDs](https://flashdata.dev/tr/docs/guides/enrich-youtube-videos/reference.md)

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

## Sadece metadata özelliğinizin ihtiyaç duyduğu meta

Seçilen ID ile örnek video_id'yu değiştirin. Basit bir video kartı veya akran-dil kontrolü için formatları ve bölümleri tut. Enable include_chapters Bir satır veya include_formats Bir medya formatını seçerken.

### metadata-request.json

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

### query.py ile bir kez gönder

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

- [Metadata yanıt alanları](https://flashdata.dev/tr/docs/sources/youtube_metadata/reference.md#response)
- [Media teslimat iş akışı](https://flashdata.dev/tr/docs/guides/media-delivery-pipeline/reference.md)

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

### Inspect available languages

results[0].transcriptLanguages'u satırları seçmeden önce okuyun. Biçimler, bölümler ve diller geri dönen video nesnesi üzerinde alanlardır; kullanım kaydı dış yanıta aittir.

| ayar ayarı | Bunu için kullanın |
| --- | --- |
| language | transcriptLanguages içinden en veya zh-Hans gibi bir kod. Bu liste manuel ve otomatik altyazı izlerini ayırt etmez. |
| auto: true | Mevcut bir otomatik olarak üretilen bir iz. |
| auto: false | Mevcut bir manuel olarak izin verilir. İki iz türü arasında bir düşüş yoktur. |

#### metadata.json · sorgu yok

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


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

## Dili seçin ve açıkça takip edin

Aynı video_id'u metadata isteğiniz ve değişen diliniz olarak kullanın ve seçilmiş pistle eşleştirmek için otomatik olarak kullanın. youtube_transcript varsayılans to auto: true; youtube_captions varsayılans to auto: false. Her ikisi de mevcut satırları alır, konuşma-to-text.

### captions-request.json

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

### query.py ile bir kez gönder

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

- [Caption parametreleri](https://flashdata.dev/tr/docs/sources/youtube_transcript/reference.md#parameters)
- [Tam bir özet oluşturun](https://flashdata.dev/tr/docs/guides/youtube-summary/reference.md)

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

### Kanıtlarla zamanları tutun

cite-segments.py'un yanında captions.json'u kurtarın ve bu klasörden çalıştırın. results[0].segments'u alıntılar için kullanın: başlangıç ve son saniyedir. languageCode ve isAutoGenerated'u metin ile koruyun. fullText okuma için yararlıdır, ancak segment zamanlamasını değiştirmiyor. Seçilen takip eksikse, başka bir sorgunun değerli olup olmadığını karar vermeden önce boşluk kaydetmek.

#### 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)
```

#### Kurtarılan satırları okuyun · API arama

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


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

## Süreç sadece bilinen bir kanaldan yeni videolar

Bir kanalla başa çıkmak ve bir video_limit (1–100) results[0].videos, son listede geri döndü; videoCount kanal metadata, geri dönüş eşya sayısı değil. Görmeniz gereken yüklemeleri kapsayan bir limit ve program seçin.

### channel-request.json

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

### query.py ile bir kez gönder

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


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

### Bir kuyruk tut ve tamamlanma kontrol noktası

Save Kaydet channel-queue.py yanında başka bir yerde query.py Ve ve channel.jsonVe o klasörden çalıştırın. Oluşturmak için argümanlar olmadan hareket edin new-ids.jsonDaha sonra süreç ve bu kişiler için kanıtları kurtarmak IDs. Run Run --commit Sadece her kuyruktan sonra ID Başarılılar; bir başarısızlık kontrol noktası değişmeden bırakır. Bu örnek için kanal ve bir işçi için tek bir rehber kullanın.

#### 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))
```

#### Plan → süreç → taahhüt

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

- [Kayıt ve tekrarlama Bilgileri](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
- [Enrich bir video listesi](https://flashdata.dev/tr/docs/guides/enrich-youtube-videos/reference.md)

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

### Taze bir kanal kontrolüne başlayın kasıtlı olarak

Soru yardımlayıcı, kurtarılmış bir yanıt olarak yeniden kullanır. Bir sonraki planlanan çek için, yeni bir sonuç dosya adı kullanın, o zaman channel.json'ye kuyruk adım için cevap veren kopyalayın. processed-ids.json'u çalıştırma arasında tut. Bu son liste tam kanal ihracat veya bir etkinlik akışı değildir.

#### Sonraki kontrol · taze bir dosya adı seçin

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

#### Durumu onaylamadan sonra durum yapılır

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


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

## Soruyu geliştirmek için önerileri kullanın

Öneriler results[0]'daki cümleleri döndürür, video kayıtlarını değil. Yararlı bir cümle seçin ve ayrı bir youtube_search isteği yapın. Araştırma yaptığınız seyirci için dil ve bölge ayarlayın.

### suggestions-request.json

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

### query.py ile bir kez gönder

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


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

## Mağaza lisansı etiketleri onları izin olarak tedavi etmeden

youtube_trainability, video için lisans etiketi döndürür. permitted: ["all"] Creative Commons anlamına gelir; ["none"] eksik lisans meta verilerini de kapsar. Video ID değerini, kaynak yanıtını ve alma tarihini saklayın. Bu etiket indirme, yeniden kullanım veya eğitim hakkı vermez.

### license-request.json

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

### query.py ile bir kez gönder

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


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

## Uygulama ve ajanlar için çalışmayı açıklayın

| Kural Kural Kuralı | Uygulama Uygulaması |
| --- | --- |
| Zenginleşmeden önce seçin | Bir konu görevi için: bir arama, seçilmiş bir video metadata ve seçilmiş bir satır pisti. Uygulamanızda çağrı bütçesini ve her kaynağı ayrı bir şekilde güçlendirin. |
| Gerçek giriş tarafından yeniden kullanılabilir | Metadata: video ID + seçenekleri. Captions: video ID + dil + takip. Kanal snapshot'ları aynı zamanda geri dönüş süresine veya ID'u çalıştırmaya da ihtiyaç duyuyor. |
| Kayıp kanıtlara Durun | Boş bir keşif sonucu yeniden denemeyin ya da sessizce kaydırın. Boşluğa dön böylece kullanıcı veya iş akışı bir sonraki eylemi seçebilirsiniz. |
| Koruma kullanımı ve başarısız çalışma | Başarılı cevaplarla kullanım tasarruf edin. 429, Retry-After'u onurlandırın; belirsiz bir teslimden sonra, başka bir ücretli sorgudan önce History'u kontrol edin. |

- [Realtime ve async](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md)
- [Batch ve Bulk](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md)
- [Hatalar ve retries](https://flashdata.dev/tr/docs/errors/reference.md#retries)
- [Mevcut fiyatlandırma ve denge](https://flashdata.dev/tr/docs/guides/credits-and-billing/reference.md)
