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

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 í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.