YouTubeギフトのAPI giftDetails【2026年10月版】｜10月12日に項目名が改名、ギフト1件で取れる8項目

ギフトで画面が動く配信を作ります。ギフトが飛んだ瞬間に何かを動かす仕掛けは、YouTubeが配信ツールに渡している情報で動いています。その情報の名前が、10月12日に1つ変わりました。ストギアが全力でサポートします。

調べ方はこうです。YouTube Live Streaming APIの「Revision history」と「LiveChatMessages」の2ページをAIに読ませ、ギフトに関する記載だけを抜き出しました。出てくる項目名は、公式ページに書かれているものだけです。

いま、ギフトの項目名が1つ変わっている

公式の更新履歴には、ギフトについて2つの日付が載っています。

名前の修正です。機能が消えたわけではありません。ただ、古い名前を見に行っているツールは、ギフトが届いても気づけません。ギフトは普通に飛んでいるのに、画面の演出だけ出ない。そういう形で現れます。

ギフト1件で、YouTubeが渡す8項目

公式リファレンスによると、giftDetails は「メッセージの種類が giftEvent のときだけ存在する」オブジェクトです。中身は8つあります。

見てほしいのは jewelsAmount と comboCount です。ジュエル数と連打の回数が、ギフト1件ごとに届いています。金額で演出を分ける土台は、YouTube側にもう用意されています。

名前が似ている3つを分ける

snippet.type には、ギフトと名のつく値が3つ並んでいます。公式の説明で分けるとこうなります。

• giftEvent：視聴者がジュエルを使ってギフトを贈った（ここが縦型ライブのギフト）
• membershipGiftingEvent：視聴者が他の視聴者にメンバーシップを買った
• giftMembershipReceivedEvent：視聴者がギフトのメンバーシップを受け取った

下の2つはメンバーシップの話です。ジュエルのギフトとは別の仕組みです。

公式が公表していないこと

• 古い名前 giftEventDetails がいつまで通るか（移行期間の記載はありません）
• ジュエル数から日本円への換算（このリファレンスには書かれていません）
• comboCount の数え方の規則（何秒以内の連打をコンボと数えるか）
• 縦型と横型で中身が変わるかどうか

次の配信でこう変える：3分の点検

1. 自分で安いギフトを1件送る。演出が出れば、今のまま動いています。1分
2. 出なかったら、使っているツールの作者に「10月12日に giftDetails へ変わった」と伝える。上の履歴ページのURLを添えるだけで話が早い。2分
3. ジュエル数の段を3つに決める。安い・ふつう・大きい。jewelsAmount で分かれるので、3段なら仕込みも軽い

地味な作業です。3分かかります。それでもコツコツやってください。ギフトが届いているのに画面が静かな配信は、送った人がいちばん寂しい思いをします。

視聴者の体験は3ステップ

• 気になる：画面の中で、何かが勝手に動いている
• 押したくなる：ギフトを送れば自分で動かせると分かる
• おお、すごい！：送った瞬間、実物のギアが回る

YouTubeの縦型ライブで同接が伸びないとき、原因は配信の中身より「画面を見た人が、自分は何をすればいいか分からない」ことにあります。送ったのに何も起きない画面は、次の人も押しません。押せるものがあると分かれば人は残る。滞在が伸びれば同接が積み上がる。ストギアはギフトに反応して実物のギアが動く仕組みで、PCもOBSも使わず、スマホだけで完結します。

次回

ジュエル数の段を3つに分けるとき、どの金額で区切ると押されやすいかを書きます。

※2026年10月16日時点で確認できた公開情報をもとにしています。

ミス・サンデー：ギフトは飛んでるのに画面が静か、だったら名前の変更を疑うといいわよ。送った人は、画面が動くのを待ってるんだから。