[MM-15278] feat(seo): emit VideoObject JSON-LD on doc pages with video

[pauloSF0]

Related issue

Google Search Console warning: "Either 'contentUrl' or 'embedUrl' should be specified" — videos not being indexed.

Changes

This PR emits a schema.org VideoObject JSON-LD on the 23 documentation pages that embed a YouTube video, so Google can index them and enable rich results. It fixes the GSC contentUrl/embedUrl warning.

The logic replicates the getVideoObjectSchema() approach already shipped in azion/site (learning/blog pages), adapted to this repo's Astro architecture:

• uses embedUrl (never contentUrl);
• derives thumbnailUrl from the YouTube ID (https://i.ytimg.com/vi/{ID}/hqdefault.jpg);
• uses the page date as uploadDate;
• omits duration.

Core changes:

• src/util/videoObject.ts (new): getVideoObjectSchema() builder.
• src/content/config.ts: added an optional video object (embedUrl + optional title/description/uploadDate/thumbnailUrl) to baseSchema. The embed is sourced explicitly from frontmatter instead of parsing the page body.
• src/components/HeadSEO.astro: emits <script type="application/ld+json"> with the VideoObject only when the page declares video (no impact on pages without video).
• 23 content files (EN + PT-BR): added the video frontmatter block (embedUrl + uploadDate).

Notes:

• The Astro frameworks page has a second embed (FIMBJBpZsdU) not in the target list — only the requested lQo6rLigHfk was marked.
• The two EN/PT-BR pairs (HOkuSudhKfE personal-tokens, soyIbJW0VdQ data-stream) were handled individually.

Verification:

• astro sync regenerates content types with no schema errors.
• Dev server: all 23/23 target URLs render a valid VideoObject with the expected embedUrl, plus thumbnailUrl, uploadDate, name and description; no contentUrl/duration.
• A page without a video emits no VideoObject.

Additional links

• Google reference: https://developers.google.com/search/docs/appearance/structured-data/video
• Validate after deploy: Rich Results Test · Schema Validator

[egermano]

@pauloSF0 aqui o mesmo comentário do repo do site precisamos desdobrar aqui. https://github.com/aziontech/site/pull/1544

[arturdj]

Tested sample of 3 videos successfully.
Maybe an astro-link-validator could help in CI/CD for this.