# แนวทางใช้ YouTube Data

ค้นหาวีดิทัศน์ที่เกี่ยวข้อง ให้เลือกแทร็กคําบรรยายภาพ แล้วทําการอัปโหลดช่องใหม่โดยไม่ทําซ้ํา

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/youtube-data-guide
Recorder: 2026-11-04 โดย FlashData

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

## เริ่มด้วยข้อมูลที่คุณมีอยู่แล้ว

แต่ละแหล่งข่าวจะตอบคําถามอื่น ข้ามการค้นพบสําหรับวิดีโอที่รู้จักกัน ID หรือ การ ติด ต่อ ทาง โทรศัพท์ และ มี แต่ วี ดิ ทัศน์ ที่ คุณ ต้องการ เท่า นั้น.

| งานของคุณ | แหล่ง | การตัดสินใจ |
| --- | --- | --- |
| ค้นหาวีดิทัศน์เกี่ยวกับหัวข้อ | youtube_search | เริ่มจากผู้สมัคร 5 คน จากนั้นเลือกตามความเกี่ยวข้อง |
| แสดงรายการวีดิทัศน์ที่รู้จัก | youtube_metadata | หาชื่อเพลง ช่อง ระยะเวลา และภาษาคําบรรยาย |
| เปรียบเทียบหรืออ้างอิงสิ่งที่พูด | youtube_transcript / youtube_captions | เลือกภาษาและร่องเสียงอัตโนมัติหรือด้วยตนเอง |
| Check appnowns ทางช่องล่าสุด | youtube_channel | เปรียบเทียบคืนแล้ว IDs กับกระบวนการของคุณ IDs. |

- [ค้นหาวิดีโอ](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md#discover)
- [ทํางานกับวิดีโอที่รู้จักกัน](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md#metadata)
- [เฝ้าดูช่อง](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md#channel)

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

## ประมวลผลตัวอย่างที่ต้องการ

บันทึกแต่ละรายการ JSON ร่างโดยใช้ชื่อแฟ้มที่แสดงอยู่ Python ใช้ query.py ผู้ช่วยเหลือด้านล่างนี้ cURL สามารถส่งไฟล์เดียวกันได้ ใช้กุญแจกับสิทธิ์ที่แหล่งอนุญาตที่คุณต้องการ และใช้เครดิตที่มีอยู่ การส่งแต่ละครั้งเป็นการสอบถามหนึ่งข้อ ไม่คํานึงถึงจํานวนวิดีโอที่ส่งกลับมา

### Python

Python 3.10+. ติดตั้งการร้องขออีกครั้ง, บันทึก query.py ข้าง ล่าง นี้ ให้ ใช้ คํา สั่ง ข้าง ๆ คํา ขอ แต่ ละ ข้อ. การส่งออกเสียงจะถูกใช้อีกครั้ง การป้อนข้อมูลที่มีการเปลี่ยนแปลงต้องการชื่อแฟ้มผลลัพธ์ใหม่

#### ติดตั้ง

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


### cURL

Bash. แทนที่ REQUEST.json ถึง RESULT.json ด้วยชื่อแฟ้มสําหรับตัวอย่างที่เลือกของคุณ Check value ก่อนทําการร้องขอซ้ํา คําสั่งนี้จะช่วยประหยัดเสียง HTTP ร่างกายแม้สําหรับความผิดพลาด

#### ส่งเอกสารที่ถูกบันทึก JSON ร้องขอ

```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 กุญแจ

เรียกข้อมูล FLASHDATA_API_KEY จากเทอร์มินัลหรือร้านค้าลับของคุณ มิ ฉะนั้น ก็ ใส่ กุญแจ โดย ใช้ คํา กระตุ้น ที่ ซ่อน อยู่ ข้าง ล่าง. จง ทํา ตาม ตัว อย่าง เหล่า นี้ ต่อ ไป.

#### Bash

##### ตั้งค่ากุญแจ

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

##### ตั้งค่ากุญแจ

```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 กุญแจ](https://flashdata.dev/app/api-keys)
- [ทดลองใช้เอเจนต์และเชื่อมโยงบัญชี](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md)

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

### บันทึก query.py สําหรับ Python ตัวอย่าง

สร้าง query.py ในโฟลเดอร์ที่ทํางานใหม่ และคัดลอกโค้ดที่สมบูรณ์ด้านล่างนี้ บันทึกการร้องขอ JSON แฟ้มและอื่น ๆ Python สคริปต์ในโฟลเดอร์นี้ และประมวลผลคําสั่งทั้งหมดจากที่นั่น

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

## หาผู้สมัครก่อนรับรายละเอียด

ตัวกรองวีดิทัศน์นี้แยกประเภทผลลัพธ์อื่น ๆ ออก; คําบรรยายจะค้นพบแคบลงเป็นวิดีโอที่มีคําบรรยายภาพอยู่ ไม่ได้เลือกภาษาของคําบรรยายภาพ หรือการรับรองค่าร่องที่คุณต้องการ บันทึกเป็น discover-request.json

### discover-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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


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

### เลือกตามสัดส่วน ไม่ใช่รายการแรก ID

บันทึก candidates.py ข้าง query.py ถึง search.jsonประมวลผลมันจากโฟลเดอร์นั้น มันยังคงการค้นหาลําดับและลบวิดีโอซ้ํา IDs. เลือกชื่อเรื่อง, ช่อง และระยะเวลา จากนั้นคัดลอก ID ไปเป็นคําสั่งถัดไป รายการที่ว่างอยู่เป็นการค้นหาเสร็จสมบูรณ์ โดยไม่มีผู้สมัคร

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

#### อ่านการค้นหาที่บันทึก

```bash
python candidates.py
```


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

### ขยายเมื่อรายการสั้นไม่เพียงพอ

รองรับการค้นหามาตรฐาน max_results ถึง 20. สําหรับคอลเลกชันที่กว้างขึ้น สลับไป youtube_search_extendedซึ่งรองรับ 700 และถูกแยกเป็นหลักทรัพย์ ตัวอย่างนี้ขอให้ 50▪ ตรวจ สอบ ดู ว่า ผล แรก ของ คุณ เป็น ประโยชน์ หรือ ไม่ ก่อน จะ ทํา ให้ ทุก คน มั่งคั่ง.

#### extended-request.json

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

#### ประมวลผลหนึ่งครั้ง

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

- [ส่งการค้นหาอย่างไม่ลดละ](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#async)
- [Entrich เลือก IDs](https://flashdata.dev/th/docs/guides/enrich-youtube-videos/reference.md)

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

## เรียกข้อมูลกํากับของคุณเท่านั้นที่ต้องการ

แทนที่ตัวอย่าง video_id ด้วยการเลือกของคุณ ID. เก็บรูปแบบและบทที่ถูกปิดการใช้งานสําหรับ บัตรวิดีโอหรือการตรวจสอบคําบรรยายภาพ เปิด include_chapters สําหรับโครงเรื่อง, หรือ include_formats เมื่อเลือกรูปแบบสื่อ

### metadata-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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

- [ช่องข้อมูลตอบรับข้อมูลกํากับภาพ](https://flashdata.dev/th/docs/sources/youtube_metadata/reference.md#response)
- [การส่งสื่อ](https://flashdata.dev/th/docs/guides/media-delivery-pipeline/reference.md)

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

### จําแนกภาษาที่มี

อ่าน results[0].transcriptLanguages ก่อนเลือกคําบรรยายภาพ รูปแบบ, บทและภาษาเป็นสาขาในวัตถุวิดีโอที่ส่งกลับ; บันทึกการใช้งานเป็นของการตอบสนองภายนอก

| ตั้งค่า | ใช้มันเพื่อ |
| --- | --- |
| language | รหัสจาก transcriptLanguages เช่น en หรือ zh-Hans รายการนี้ไม่สามารถแยกแยะแทร็กคู่มือและเพลงอัตโนมัติได้ |
| auto: true | มีร่องเสียงที่ถูกสร้างมาโดยอัตโนมัติ |
| auto: false | มีร่องเสียงที่มีอยู่แล้ว ไม่มีการผิดพลาดระหว่างแนวเพลงทั้งสองเลย |

#### อ่าน metadata.json ไม่ต้องสอบถาม

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


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

## เลือกภาษาและแทร็กเสียงโดยตรง

ใช้แบบเดียวกัน video_id เป็นการร้องขอข้อมูลกํากับภาพของคุณ และเปลี่ยนภาษาและอัตโนมัติให้ตรงกับเพลงที่เลือก youtube_transcript ค่าปริยายไปยัง auto: true; youtube_captions ค่าปริยายไปยัง auto: false. ทั้งสองได้คําบรรยายที่มีอยู่แล้ว ไม่ใช่คําพูดต่อข้อความ

### captions-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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

- [พารามิเตอร์ของคําบรรยายภาพ](https://flashdata.dev/th/docs/sources/youtube_transcript/reference.md#parameters)
- [สร้างการสรุปที่สมบูรณ์](https://flashdata.dev/th/docs/guides/youtube-summary/reference.md)

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

### เก็บเวลาไว้กับหลักฐาน

บันทึก cite-segments.py ข้าง captions.json และเรียกมันจากโฟลเดอร์นั้น ใช้ results[0].segments ข้อความ: เริ่มและจบคือวินาที รักษา languageCode ถึง isAutoGenerated ด้วยข้อความ fullText มีประโยชน์ในการอ่าน แต่ไม่ได้แทนที่จังหวะส่วน หาก ไม่ มี การ บันทึก ร่อง เสียง ที่ เลือก ไว้ ให้ บันทึก ช่อง ว่าง นั้น ก่อน ตัดสิน ใจ ว่า จะ คุ้ม ค่า กับ การ สอบ ถาม อีก หรือ ไม่.

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

#### อ่านจดหมายที่บันทึกคําบรรยายภาพNo API

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


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

## ประมวลผลเฉพาะวีดิทัศน์ใหม่จากช่องที่รู้จัก

ใช้ด้ามจับทางช่องและผูก video_limit (1–100). results[0].videos เป็นรายการที่ส่งเข้ามาล่าสุด videoCount เป็นข้อมูลทางช่อง ไม่ใช่จํานวนของรายการที่ส่งกลับมา เลือก จํากัด และ ตาราง เวลา ที่ ครอบ คลุม การ อัปโหลด ที่ คุณ ต้อง สังเกต.

### channel-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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


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

### เก็บคิวและจุดตรวจที่เสร็จสมบูรณ์ไว้

บันทึก channel-queue.py ข้าง query.py ถึง channel.jsonและตรวจสอบมันจากโฟลเดอร์นั้น ประมวลผลโดยไม่มีอาร์กิวเมนต์ที่จะสร้าง new-ids.jsonจากนั้นดําเนินการและเก็บหลักฐานเหล่านั้น IDs. ทํางาน --commit หลังจากทุกคิว ID ความสําเร็จ; ความล้มเหลวทําให้จุดตรวจไม่เปลี่ยนแปลง ใช้ไดเรกทอรีหนึ่งตัวต่อช่อง และคนงานหนึ่งตัวสําหรับตัวอย่างนี้

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

#### แผน ○ โพรเซส ที่ ทํา งาน

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

- [กําหนดวันและทําการสร้างเอกสารใหม่](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)
- [แก้ไขรายการวีดิทัศน์](https://flashdata.dev/th/docs/guides/enrich-youtube-videos/reference.md)

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

### เริ่มการทํางานการตรวจสอบช่องใหม่อย่างจงใจ

ผู้ช่วยเหลือการสอบถามทําการตอบรับที่บันทึกไว้อีกครั้ง สําหรับการตรวจสอบตามกําหนดการถัดไป ใช้ชื่อแฟ้มใหม่ ตรวจดู จากนั้นคัดลอกที่เสร็จสมบูรณ์แล้วเพื่อตอบโต้ channel.json สําหรับขั้นตอนคิว ให้ processed-ids.json อยู่ระหว่างการทํางาน รายการนี้ไม่ใช่รายการส่งออกแบบเต็ม ๆ หรือเป็นพาธของเหตุการณ์

#### Check ถัดไป

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

#### หลังจากยืนยันสถานะเสร็จแล้ว

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


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

## ใช้ ข้อ เสนอ แนะ เพื่อ ปรับ ปรุง การ สอบ ถาม

ข้อแนะนําการคืนคําใน results[0], ไม่ใช่บันทึกวิดีโอ เลือกวลีที่มีประโยชน์แล้วแยกออกมา youtube_search ขอล่ะ ตั้งค่าภาษาและขอบเขตสําหรับผู้ชมที่คุณกําลังศึกษาอยู่

### suggestions-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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


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

## จัดเก็บป้ายใบอนุญาตโดยไม่พิจารณาสิทธิ์

youtube_trainability HOURSฟังก์ชัน () จะคืนค่ากลับมาเป็นชั่วโมงของค่าเวลาที่กําหนด"all") แผนที่งานสร้างสรรค์คอมมอนส์ (พ.ศ."none") ยังครอบคลุมข้อมูลใบอนุญาตหายด้วย เก็บวิดีโอ ID, sources การตอบรับและวันที่เรียกข้อมูล ป้ายนี้ไม่ให้สิทธิ์ในการดาวน์โหลด, ทําซ้ําหรือใช้สิทธิ์ในการฝึกอบรม

### license-request.json

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

### ส่งข้อมูลหนึ่งครั้งด้วย query.py

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


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

## จํากัดการทํางานสําหรับ apps และตัวแทน

| กฎ | การเติมให้สมบูรณ์ |
| --- | --- |
| เลือกก่อนทําให้สมบูรณ์ | สําหรับหัวข้องาน: การค้นหาหนึ่งรายการ ข้อมูลกํากับภาพของวิดีโอที่เลือกไว้ และเพลงที่เลือกใช้คําบรรยาย บังคับใช้งบประมาณในการโทรในแอพของคุณ และราคาแต่ละแหล่งแยกกัน |
| ปรับใช้ค่าจากค่าที่ป้อนเข้าไปจริง | ข้อมูลกํากับภาพ: วิดีโอ ID + ทางเลือก คําบรรยาย: วิดีโอ ID + แทร็กเสียงภาษา + จับภาพทางช่อง ต้องการเวลาเรียกข้อมูล หรือเรียกใช้ ID |
| หยุดเรื่องหลักฐานที่หายไป | ไม่ต้องลองค้นหาผลลัพธ์ที่ว่างเปล่า หรือสลับป้ายบรรยายแบบเงียบ ๆ กลับค่าช่องว่างเพื่อให้ผู้ใช้หรือรุ่นที่ทํางานเลือกการกระทําต่อไปได้ |
| การรักษาการใช้งานและทํางานล้มเหลว | บันทึกการใช้งานด้วยการตอบสนองที่ประสบความสําเร็จ เปิด 429เป็นเกียรติยิ่ง Retry-Afterหลังจากการยอมจํานนที่ไม่แน่นอนตรวจสอบ History ก่อนการสอบถามที่ต้องจ่าย |

- [Realtime และ async](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md)
- [Batch และ Bulk](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md)
- [เกิดข้อผิดพลาดและทําการปรับปรุงใหม่](https://flashdata.dev/th/docs/errors/reference.md#retries)
- [ค่าเบี่ยงเบนมาตรฐาน](https://flashdata.dev/th/docs/guides/credits-and-billing/reference.md)
