# FlashData a oficjalne YouTube Data API

Wybierz po zadaniu, porównaj jedną odpowiedź metadanych i sprawdź autoryzację zapisu i koszty użytkowania.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/flashdata-vs-youtube-data-api
Przegląd: 2026-11-04 przez FlashData

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

## Wybierz po zadaniu

FlashData jest oddzielną usługą od Google YouTube Data API. Kwalifikacje, pola odpowiedzi i modele rozliczeń są różne.


<a id="comparison"></a>

### W mgnieniu oka

| Zadanie | Oficjalne YouTube Data API | FlashData |
| --- | --- | --- |
| Metadane wideo | videos.list | youtube_metadata |
| Wyszukiwanie i odkrywanie | YouTube zapytania o zasoby i pogaństwo. | Wyszukiwarka standardowa / rozszerzona, kanały i sugestie. |
| Ścieżki przechwytywania | Autoryzowane operacje caption; pliki do pobrania wymagają zgody na edycję filmu. | Pobieranie istniejących utworów dla żądanego języka i źródła napisy. |
| Zmiany konta | Dokumentowane pliki i inne upoważnione pisma. | Pobieranie i dostarczanie; brak mutacji na koncie YouTube. |
| Pliki multimedialne | Reakcja zasobów wideo to metadane. | Tło pobiera się do magazynu. |

- [Przegląd Google API](https://developers.google.com/youtube/data/getting-started)

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

## Porównaj jedno żądanie metadanych

Należy stosować Bash, cURL i jq. Dla Google, włącz YouTube Data API v3 w swoim projekcie i ustaw GOOGLE_API_KEY. Dla FlashData, ustaw FLASHDATA_API_KEY za zgodą youtube_metadata. Każda karta składa jeden wniosek i zapisuje swoją odpowiedź; uruchom dostawcę, którego chcesz ocenić.

### FlashData

#### Bash · flashdata-metadata.json

```bash
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "youtube_metadata",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
  flashdata-metadata.json
)
```


### Oficjalne YouTube API

#### Bash · official-metadata.json

```bash
(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
  'https://www.googleapis.com/youtube/v3/videos' \
  --data-urlencode "key=$GOOGLE_API_KEY" \
  --data-urlencode 'part=snippet,contentDetails' \
  --data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
  channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
  official-metadata.json
)
```


- [Ustaw klawisz FlashData](https://flashdata.dev/pl/docs/guides/http-quickstart/reference.md#prepare)
- [videos.list](https://developers.google.com/youtube/data/reference/rest/v3/videos/list)
- [Schemat metadanych FlashData](https://flashdata.dev/pl/docs/sources/youtube_metadata/reference.md#response)

<a id="fields"></a>

### Mapowanie pól wyników

Udana odpowiedź zawiera wymagane wideo. Pusta tablica items/results oznacza, że nie został zwrócony żaden pasujący rekord. Zachowaj pierwotną odpowiedź i pola mapy wyraźnie w aplikacji.

| Wartość | Oficjalna odpowiedź | Odpowiedź FlashData |
| --- | --- | --- |
| Identyfikator filmu | items[0].id | results[0].videoId |
| Tytuł | items[0].snippet.title | results[0].title |
| Nazwa kanału | items[0].snippet.channelTitle | results[0].channel |
| Czas trwania | contentDetails.duration · ISO 8601 | czas trwania · sekundy |


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

## Oddzielnie sprawdzić podpisy

Googlejest captions.download wymaga OAuth autoryzacja i pozwolenie na edycję filmu. FlashData pobiera istniejące utwory: Domyślnie transkrypt do automatycznego zapisu; Podpisy domyślnie uploaderowane utwory. Określ język i auto wyraźnie podczas porównywania wyjść.

FlashData nie generuje transkrypcji ani tłumaczenia. Jej licencjat-etykieta źródłowe raporty Creative Commons metadane; nie przyznaje prawa do szkolenia lub odczytu osobnego szkolenia-zezwolenia twórcy ustawienia.

- [Wymogi dotyczące zapisu Google](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)
- [Wybierz język i ścieżkę](https://flashdata.dev/pl/docs/guides/youtube-data-guide/reference.md#captions)
- [Pola etykiet licencji](https://flashdata.dev/pl/docs/sources/youtube_trainability/reference.md)

<a id="workflows"></a>

## Przenieś z jednego filmu na kolekcję

Wybierz przepływ pracy FlashData, który pasuje do Twojego wejścia. Standard Search akceptuje do 20 wymagane wyniki; Rozszerzone Wyszukiwarka akceptuje do 700 w osobnej stawce.

| Wejście | Przepływ pracy |
| --- | --- |
| Zapytanie tematyczne lub wyszukiwanie | Standardowe lub rozszerzone wyszukiwania → zapisać wideo IDs → metadane. |
| Mała lista wniosków | Regularne składanie partii z wynikami pracy. |
| Plik wideo IDs | Metadane Bulk, transkrypcja, podpisy, etykiety licencyjne lub pobieranie. |

- [Ubogacenie listy wideo](https://flashdata.dev/pl/docs/guides/enrich-youtube-videos/reference.md)
- [Przepis metadanych Bulk](https://flashdata.dev/pl/docs/guides/bulk-metadata-recipe/reference.md)

<a id="billing"></a>

## Porównywanie kwot i kredytów

Google stosuje kwoty projektowe i koszty specyficzne dla metodyki. FlashData wykorzystuje konta współdzielone Kredyty i stawki specyficzne dla źródła; korzystanie z pobierania jest oparte na dostarczanych bajtach medialnych. Sprawdź metody, opłaty za plan i obciążenie pracą, które rzeczywiście będziesz używać.

- [Koszty kwot Google](https://developers.google.com/youtube/data/determine_quota_cost)
- [FlashData Kredyty i ceny](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md)
