# Videóséma automatikus kitöltése YouTube-videóból

> A tartalomban talált első YouTube-videó adataiból a SEOPress automatikusan kitölti a VideoObject sémát.

Ha bekapcsolod ezt a beállítást, a SEOPress megkeresi a bejegyzés, oldal vagy egyedi tartalomtípus tartalmában az első beágyazott YouTube-videót, és abból tölti ki az adott URL Videó (`VideoObject`) strukturált adatait. Nem kell tartalmanként kézzel bemásolnod a címet, leírást, bélyegképet, feltöltési dátumot és hosszt a Videó séma metaboxába. Több beágyazott videó esetén csak az első számít.

## Miért hasznos

A `VideoObject` az a típus, amiből a Google megérti a videót az oldalon. Teljes és érvényes jelölésnél a Google megjelenítheti a videót rich találatként, bélyegképet mutathat a hivatkozás mellett, felveheti az oldalt a Videók fülre és a Discoverbe, és a videó fontos pillanatait és részleteit is indexelheti, ha a megfelelő tulajdonságok megvannak. Jelölés nélkül is indexelhető az oldal, de a kapcsolatot a kereső magának kell kitalálja.

## Követelmények

- SEOPress PRO.
- A tartalomban legalább egy YouTube-beágyazás van: blokkos beágyazás, külön sorba írt oEmbed URL, vagy `youtube.com` / `youtu.be` címre mutató iframe.
- A weboldal tud kimenő HTTP-kéréseket küldeni a YouTube oEmbed végpontjára és a bélyegkép-URL-ekre. Ha a tárhely blokkolja a kimenő kéréseket, a SEOPress nem tudja lekérni az adatokat.

## Bekapcsolás

1. Nyisd meg a **SEO → PRO** oldalt, **Strukturált adattípusok** fül.
2. Kapcsold be a **Videóséma automatikus kitöltése az első YouTube-videóból** beállítást.
3. Mentsd a módosításokat.

![A videóséma automatikus kitöltésének kapcsolója a Strukturált adattípusok fülön](./kepek/strukturalt-adatok-tipusok-beallitasok.webp)

*A videóséma automatikus kitöltésének kapcsolója a Strukturált adattípusok fülön* (https://minta-bolt.hu/wp-admin/admin.php?page=seopress-pro-page)

Ettől kezdve minden, a szabálynak megfelelő, YouTube-beágyazást tartalmazó tartalom `VideoObject` JSON-LD blokkot ad ki a nyilvános oldalon.

Az oldalon az alábbi kapcsolódó beállítás is megvan:

| Beállítás | Mit csinál |
| --- | --- |
| **YouTube Data API-kulcs** | Opcionális. Kulcs nélkül csak a videó címe és bélyegképe kérhető le. Ilyenkor a Video-sémából és az XML-videó-oldaltérképből hiányzik a leírás, a feltöltés dátuma és az időtartam. Saját API-kulccsal minden részlet lekérhető a saját napi kvótád terhére. A videók lekérése a bejegyzés mentésekor történik, nem az oldal megjelenítésekor. Az **API-kulcs tesztelése** gombbal ellenőrizheted a kulcsot. |

## Mely tulajdonságok töltődnek ki

| Tulajdonság | Forrás |
| --- | --- |
| `name` | a YouTube-videó címe |
| `description` | a videó leírása |
| `thumbnailUrl` | a YouTube nagy felbontású bélyegképe |
| `uploadDate` | a YouTube által adott közzétételi dátum |
| `duration` | a hossz ISO 8601 formátumban, például `PT4M13S` |
| `contentUrl`, `embedUrl` | a kanonikus YouTube-címek |

Ha a YouTube valamelyik értéket nem adja vissza, a SEOPress kihagyja a tulajdonságot, üres szöveget nem ír ki.

## Az eredmény ellenőrzése

1. Mentsd a bejegyzést, és töltsd be a nyilvános oldalon.
2. Nézd meg az oldal forrását, és keresd a `"@type":"VideoObject"` szöveget. Egy blokkot kell látnod a fenti tulajdonságokkal.
3. Futtasd az URL-t a Google Rich Results Testen, és ellenőrizd, hogy a Videó eredmény hibák nélkül felismerhető.
4. Search Console használatakor figyeld a Videók jelentést a következő hetekben.

Ha a `VideoObject` hiányzik, ellenőrizd, hogy a tartalomban tényleg van YouTube-beágyazás, hogy a séma szabálya vonatkozik a bejegyzéstípusra, és hogy a szerver nem blokkolja a `youtube.com` felé menő kéréseket.

## Mikor érdemes kézzel kitölteni

Az automatikus kitöltés időt spórol, de a szerkesztői döntést nem váltja ki. Kézzel add meg a mezőket, ha:

- a YouTube-cím általános vagy sablonos, és az oldal témájához igazodó leírást szeretnél;
- a tartalom első YouTube-beágyazása nem az oldal fő videója (például egy ajánló blokkban van a valódi téma előtt).

Ilyenkor töltsd ki a Videó séma metabox megfelelő mezőit, a SEOPress összefésüli őket a lekért adatokkal.

## Gyakori kérdések

**Működik Vimeóval, Wistiával vagy saját tárhelyű videóval?** Nem, a funkció csak a YouTube-ra készült. Más szolgáltatónál a Videó séma metaboxát töltsd ki kézzel.

**Mi történik, ha később kicserélem a videót?** A bejegyzés következő mentésekor a SEOPress újra beolvassa az első YouTube-beágyazást, és frissíti az automatikusan kitöltött értékeket. A kézzel kitöltött mezők megmaradnak.

**Lassítja az oldalt?** Nem. A lekérés mentéskor történik, nem minden látogatói kérésnél, és a kirenderelt JSON-LD a bejegyzéssel együtt gyorsítótárazott.