がとらぼ

最近、「がとらぼ」の中の人はウェブの構造化データにハマッている。(JSON-LDね)
ウェブの記事の本文を明示するArticle構造化データやパンくずリストのBreadcrumbList構造化データ、製品情報を明示するProduct構造化データは既にWordPressのテンプレートやカタログシステム含め「完全自動化」で実装した。
で、「がとらぼ」の中の人がどちらかというと苦手としている動画についても数が多くはないもののウェブサイトに貼っているのでこれの構造化データにも着手したいと考えた。が、数が少ないとはいえ片手の指を折り曲げて数えられる程度というわけではないので全て手動で作成するというのは面倒そう。そこで「半自動化」にしたいと思った。

「がとらぼ」の中の人は大昔に作成した動画を除いてはほぼYouTubeにアップロードして、そのYouTube動画をブログ等に貼っているので動画というのはほぼYouTube。ウェブサイトに貼る他人の動画をも(ほぼ?)全てYouTubeのものなので基本的にはYouTubeの動画のメタ情報取得して構造化データに変換するツールを作れば良さそう。Google公式のYouTube Data APIが提供されているのでYouTube動画のページURLか動画IDからとても簡単に動画情報を取得できる。あとはその情報を加工してVideoObject構造化データ(動画構造化データ)を作成するだけ。この部分だけスクリプトでやらせれば良いかなと。

これは非常に簡単ということもあって自分でもびっくりするほどサクッとできた。
そしたら、なんか調子に乗ってしまいウェブ用ツールに改造。数個のオプションも追加して1週間ほどで公開の運びとなりました。

2022年8月25日時点では、YouTubeの場合は動画URLは動画ファイルURL(実体)ではなくウェブページへの組み込み用のURLを使うのが適切という理解なので動画ファイルURLを示す「contentUrl」は「使わない」、ヴェブページにYouTubeの動画を組み込む際に使用する https://www.youtube.com/embed/XXXXXXXXXXX?feature=oembed 形式のURLを「embedUrl」で示すようにしている。「がとらぼ」の中の人は「これで正しいよね？」と思っているが、イマイチ確信には至っていない。もしも「いやそれ違うよ」とか「より適切なのはこうよ」というのがあればご教示ください。

公開場所: 悪いインターネット YouTube動画構造化データ作成支援
例によっていつものように「悪いインターネット」に置いています。

YouTube Data APIの使用制限が厳しくて1日に利用できる回数がかなり少ないです。そこで、このウェブツールは1IPアドレスから24時間で20回までの制限とさせていただきます。「悪いインターネット」はアクセスが少ないとはいえ1日「数人」が数回ずつ使用するだけで制限を迎える計算です。
使えないよということであったら恐らくYouTube Data APIの使用制限なのでゴメンナサイ。

<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "VideoObject",
    "name": "ダイソーの300円USBスピーカーでコンクリートスピーカーを作る",
    "description": "「ダイソーの300円USBスピーカーでコンクリートスピーカーを作る」https://gato.intaa.net/archives/24736　の関連動画です。\nダイソーの300円スピーカーを片側約2.4kg(両側約5kg)のモルタルで作ったエンクロージャに埋め込みました。パッシブラジエーターを入れたので空気室は狭め(片側200ml)で完全密閉。\n硬くしっかりした箱鳴りの無いスピーカーに仕上げました。\nこの動画は音の変化を聴き比べようという試みでしたが、マイクがおもちゃなので動画ではあまり違いがよく判らず。(耳で直接聴くと大違い)\n一応、比較用に似たようなスピーカーを搭載したロジクールのZ120BWも。ただし、耳分量でこんなもんだろうと音量を決めたら小さかったみたい。\nコンクリートスピーカーのアンプは改造前と同じダイソースピーカー内蔵の低音が出ないアンプで、音量設定も改造前と同じですが音量がだいぶ大きくなった様に聞こえます。これはパッシブラジエーターのよるものと思われます。中高音はキビキビ、悪く言えば硬い感じ。低音は僅かに改善するも基本的には出ていない。元のペラペラエンクロージャで変な音が鳴っていたのがなくなってしっかり鳴るようになったので総合的には大改善。後日、アンプを変えて試す予定。プラス一回り大きなスピーカーも作成予定。",
    "thumbnailUrl": [
        "https://i.ytimg.com/vi/Q2zcPxCn3vg/default.jpg",
        "https://i.ytimg.com/vi/Q2zcPxCn3vg/mqdefault.jpg",
        "https://i.ytimg.com/vi/Q2zcPxCn3vg/hqdefault.jpg",
        "https://i.ytimg.com/vi/Q2zcPxCn3vg/sddefault.jpg",
        "https://i.ytimg.com/vi/Q2zcPxCn3vg/maxresdefault.jpg"
    ],
    "uploadDate": "2020-05-22T14:34:14Z",
    "duration": "PT2M46S",
    "embedUrl": "https://www.youtube.com/embed/Q2zcPxCn3vg?feature=oembed"
}
</script>

人が読みやすいようにJSONエンコード無し、整形あり、「/」をエスケープしないという3つのオプションをオンだとこんな感じ。こちらの方が良いというならこれをウェブサイトに貼っても問題ないみたい。少なくともGoogleさんのリッチリザルト テストはこれでも通る。

オプション(3つ):オフで出力した。数行に見えるけど、実際は1行。日本語は \uXXXX みたいな文字コードに変換されてるので理解できないものになってるけどウェブサイトに貼るのはこんな感じ。