# Közösségi hírfolyam: YouTube API-kulcs és Vimeo-token beszerzése

> Hogyan szerzel YouTube Data API-kulcsot a Google Cloud konzolon és hozzáférési tokent a Vimeo fejlesztői oldalán a Közösségi hírfolyam widgethez.

A **Közösségi hírfolyam** YouTube- és Vimeo-forrásához hozzáférési adat kell. A YouTube-hoz egy Google Cloud-projektből szerzett API-kulcs, a Vimeóhoz a Vimeo fejlesztői oldalán generált token. Mindkettőt a widgetben az elem **Hozzáférési token** mezőjébe illeszted. A mező használatát a [YouTube és Vimeo hírfolyam fejezet](https://hub.hellowp.io/hu/plugins/theplus_elementor_addon/kozosseg-funkciok-hirfolyam-youtube-vimeo/) írja le.

A lépések a Google, illetve a Vimeo saját felületén zajlanak, nem a WordPressben. Ezek a felületek időnként átalakulnak, ezért a sorrendet tekintsd útmutatónak.

## YouTube API-kulcs

A YouTube a YouTube Data API-n keresztül érhető el, amelyhez egy Google Cloud-projektben létrehozott API-kulcs kell. A kulcs nem hozzáférési token, és nincs bejelentkezés, de a widgetnek forrásonként egyetlen hitelesítő mezője van, ezért a kulcs a **Hozzáférési token** nevű mezőbe kerül.

Előfeltétel: egy Google-fiók.

1. Jelentkezz be a Google-fiókodba, és nyisd meg a Google Developers Console-t (console.developers.google.com).
2. Ha még nincs projekted, kattints a **CREATE PROJECT** gombra. Ha már van, nyisd ki a felső legördülőt, és a **Select a Project** ablakban kattints a **New Project** pontra.
3. Add meg a **Project name** mezőt, és kattints a **CREATE** gombra.
4. Válaszd ki a projektet az értesítésből vagy a felső legördülőből.
5. Kattints felül a **+ ENABLE APIS AND SERVICES** gombra.
6. Keress rá a „YouTube” szóra, és válaszd ki a **YouTube Data API v3** elemet.
7. Kattints az **ENABLE** gombra.
8. A bal oldali sávban kattints a **Credentials** pontra.
9. A Credentials oldal tetején kattints a **+ CREATE CREDENTIALS → API key** pontra.
10. A kulcs egy felugró ablakban jelenik meg. Kattints a másolás gombra, mentsd el a kulcsot, és kattints a **CLOSE** gombra.
11. Korlátozd a kulcsot: a **SHOW KEY** melletti három pontra kattintva válaszd az **Edit API Key** pontot.
12. Az **API restrictions** alatt válaszd a **Restrict Key** lehetőséget.
13. A **Select APIs** legördülőből válaszd ki a 6. lépésben engedélyezett **YouTube Data API v3** elemet, kattints az **OK** gombra, majd a **SAVE** gombra.

A kulcs kész. Illeszd be a widget **Hozzáférési token** mezőjébe, és válassz **YouTube-típust**.

### YouTube-korlátok

- A YouTube Data API-nak napi kvótája van. Minden gyorsítótárból ki nem szolgált oldalmegjelenítés fogyaszt belőle. Ha a kvóta elfogy, az API a visszaállásig nem válaszol, és a widget hibakártyát mutat. A **Teljesítmény** bekapcsolása és az 1 napos **Frissítési idő** alacsonyan tartja a hívásszámot.
- A rossz API-ra korlátozott kulcs elrontja a hírfolyamot. Ha korlátozol, a korlátozásnak tartalmaznia kell a YouTube Data API v3-at.
- Az API-kulcs az oldal megjelenítésekor nyilvánossá válik, ezért korlátozd (ezért van a 11. és a 13. lépés közötti korlátozás), ne hagyd korlátozás nélkül.
- A kulcs csak nyilvános adatot ér el. Magán vagy listázatlan videókhoz OAuth kellene, amit a widget nem használ.
- Hogy a HTTP-hivatkozó szerinti korlátozás használható-e, nem derül ki: a kérést a szervered küldi, nem a böngésző, ezért a hivatkozó szerinti korlátozás nem biztos, hogy a várt módon működik. A leírt módszer az API szerinti korlátozás.

### YouTube-hibaelhárítás

**„Somthing Wrong” és „Error Code : 400”.** A Google elutasította a kérést. Sorban nézd meg: a kulcs a **Hozzáférési token** mezőben van-e, a YouTube Data API v3 engedélyezve van-e a projekten, a kulcs korlátozása tartalmazza-e ezt az API-t, és a **YouTube-típus** alatti mező a megfelelő fajta azonosítót tartalmazza-e.

**Reggel még működött, délután megállt.** Ez a napi kvóta jellegzetes mintája. Kapcsold be a **Teljesítmény** kapcsolót, hogy a hírfolyam a frissítések között az adatbázisból jöjjön.

**Nem találom meg újra a kulcsot.** Nyisd meg a projekt **Credentials** oldalát, és kattints a **SHOW KEY** gombra. A hozzáférési tokentől eltérően az API-kulcs visszaolvasható.

**Korlátoztam a kulcsot, és elromlott a hírfolyam.** Szerkeszd a kulcsot, és az **API restrictions** alatt jelöld be a **YouTube Data API v3** elemet.

## Vimeo-hozzáférési token

A Vimeo folyamata a legrövidebb a négy közül: létrehozol egy alkalmazást, generálsz magadnak egy tokent, és kimásolod.

Előfeltétel: egy Vimeo-fiók, amelybe be tudsz jelentkezni.

1. Jelentkezz be a Vimeo-fiókodba, és nyisd meg a Vimeo fejlesztői oldalát (developer.vimeo.com).
2. Kattints a **Create an app** gombra.
3. A következő oldalon add meg az alkalmazás adatait: az alkalmazás nevét, leírását és hozzáférhetőségét. Fogadd el a feltételeket, majd kattints a **Create App** gombra.
4. A következő oldal bal oldali sávjában kattints a **Generate Access Token** hivatkozásra.
5. Az **Authentication** szakaszban válaszd az **Authenticated (you)** lehetőséget, majd kattints a **Generate** gombra.
6. Megjelenik a hozzáférési token. Másold ki és tárold biztos helyen, a Vimeo többször nem mutatja meg.

Illeszd be a tokent a widget **Hozzáférési token** mezőjébe, és válassz **Vimeo-típust**.

### Vimeo-korlátok

- A hitelesített token a te nevedben jár el. Azt éri el, amit a Vimeo-fiókod, és semmivel többet. Egy magáncsatorna, amelynek nem vagy tagja, elérhetetlen marad.
- A Vimeo a tokent egyszer mutatja meg. Ha elveszted, generálj újat, a régit nem olvashatod vissza.
- A hatókörök számítanak. Ha a token szűkebb hatókörrel készült, mint amit a hírfolyam kér, a kérést mint minden hibásat, elutasítják, és a widget hibakártyát mutat.
- Hogy melyik Vimeo-típushoz milyen hatókör kell, nem derül ki. Ha egy típust érvényes token mellett is elutasít, a hiányzó hatókör az első gyanús.

### Vimeo-hibaelhárítás

**A hírfolyam „Somthing Wrong” és „Error Code : 400” feliratot mutat.** A Vimeo elutasította a kérést. Nézd meg, hogy a token teljes-e (hosszú, és másoláskor könnyű levágni), és hogy a **Vimeo-típus** alatti mezőben a címsorból vett azonosító áll, nem a megjelenített cím.

**„Empty Access Token”.** Az elem **Hozzáférési token** mezője üres.

**Nem találom a Generate Access Token pontot.** Az alkalmazás saját oldalának bal oldali sávjában van, nem az alkalmazások listájában.