YouTube のアップロード失敗では、エラーコード 453(タイムアウト)または 454
(サービス利用不可)が
retryAvailable: true とともに返される場合があります。統合コードは
このフラグを分岐して、一時的な失敗を自動的にバックオフ付きで再試行できます。
すべてのリストは エラーコードリファレンス を参照してください。YouTube への投稿
投稿の概要
YouTube API を使った投稿には、youTubeOptions オブジェクトと少なくとも title パラメーター(最大 100 文字)が必要です。
title は必須の唯一のフィールドで、transcribe エンドポイント で自動生成することもできます。
たとえば、デフォルト設定で YouTube 動画を投稿する場合:
YouTube Post
private ですが、公開範囲を public または unlisted に設定することもできます。
詳細は下記のオプションフィールドを参照してください。
YouTube 投稿のオプションフィールド
動画のvisibility、tags、publishAt 日付など、他にもいくつかのオプションフィールドがあります。要件と説明については以下のコメントを参照してください。
YouTube Post Optional Fields
titleは 100 文字以下にする必要があります。postは 5,000 文字以下にする必要があります。postとtitleには < と > を除く任意の文字を含めることができます。- Playlist Id は、プレイリストをブラウザで開き、
list=の後の値をコピーすることで取得できます。動画を追加するには、認証済みユーザーとチャンネルがプレイリストの所有者である必要があります。 - 動画が mp4 などの既知の動画拡張子で終わらない場合、
isVideoパラメーターを使用してください。詳細は /post エンドポイント を参照してください。 publishAtフィールドを指定すると、YouTube が公開時刻を制御できるようになります。 動画は公開時刻までプライベートとなり、その時刻に公開されます。 公開時刻が過去の場合、動画はすぐに公開されます。publishAtフィールドを使用する際は、投稿のscheduleDateフィールドを使用しないでください。containsSyntheticMediaフィールドは、動画がリアリスティックに改変・合成された (A/S) コンテンツを含むことを開示するために使用します。具体的には、実在の人物が実際には言っていない・していないことを言ったり行ったりしているように見せる、実際の出来事や場所の映像を改変する、実際には起こらなかったリアリスティックに見えるシーンを生成する、などです。license— 動画のライセンスタイプを設定します。受け付ける値:"youtube"(標準 YouTube ライセンス、デフォルト)または"creativeCommon"(Creative Commons - Attribution)。embeddable— ブール値(または文字列"true"/"false")。サードパーティのウェブサイトに動画を埋め込めるかを制御します。デフォルト:true。publicStatsViewable— ブール値(または文字列"true"/"false")。動画の視聴ページにある 拡張統計パネル が公開閲覧可能かを制御します。基本的な再生回数といいね数は、この設定に関わらず引き続き公開表示されます。デフォルト:true。詳細は YouTube Data API リファレンスのstatus.publicStatsViewableを参照してください。- 詳細は YouTube Media Guidelines を参照してください。
収益化とコンテンツ管理
madeForKids、license、embeddable、publicStatsViewable の各フィールドは、Ayrshare API を通じてアップロード時に設定可能です。ただし、直接の収益化トグル(広告の有効/無効)、広告タイプの選択(プレロール、ミッドロール、ポストロール)、収益分配、Content ID は YouTube CMS の認証情報が必要で、これらは MCN やエンタープライズコンテンツオーナーのみが利用可能であり、標準の YouTube OAuth や Ayrshare API では 利用できません。YouTube Shorts
YouTube Short は、最大 3 分の縦型ショート動画です。 これは TikTok の動画や Instagram / Facebook の Reels に似ています。YouTube Shorts の投稿
youTubeOptions オブジェクトに shorts パラメーターを追加することで、最大 3 分の YouTube Shorts 動画を投稿できます。
YouTube Shorts Post
YouTube Shorts に関する重要な情報
- 動画を Short として送信することは、その動画を Short として表示したいという意図を YouTube に伝えるだけであり、Short として表示されることを保証するものではありません。動画は Short 動画 の要件(3 分以内、縦向きアスペクト比 9:16 など)を満たす必要があり、YouTube によって Short として認識されます。
- YouTube Shorts はサムネイルをサポートしていません。
- API を使った YouTube Shorts の投稿 についての追加情報。
YouTube サムネイル
カスタムサムネイルには 認証済みの YouTube チャンネル が必要です。動画は投稿されるがサムネイルが適用されない最も一般的な原因は、認証されていないチャンネルです。https://www.youtube.com/verify で電話番号による認証を行ってください。
thumbNail は PNG または JPG/JPEG、2MB 以下、到達可能な URL から提供される必要があります。Ayrshare は可能な限り公開前にこれらを検証します。動画は投稿されたがサムネイルが失敗した場合、YouTube の結果は status: "success" のまま、warnings 配列(feature: "thumbnail"、code: 307)が失敗を説明します。完全な修正方法については YouTube Thumbnail Not Applied (Unverified Channel) を参照してください。YouTube サムネイルの追加
YouTube サムネイルや、15 分の動画のアップロードなどの他の機能を使用するには、電話番号の認証が必要です。thumbNail は、JPEG または PNG の URL で 2MB 未満のサイズです。ファイル拡張子は png、jpg、jpeg のいずれかで終わる必要があります。
YouTube Thumbnail
YouTube Studio でサムネイルを有効にする
サムネイルを投稿するには、YouTube から権限を付与されている必要があります。YouTube Studio で Settings->Channel に移動します。「Feature Eligibility」を選択し、「Features that require phone verification」をクリックします。電話番号を入力して有効化します。
動画: API 経由での YouTube への投稿
アップロード制限
YouTube では、24 時間以内にチャンネルが YouTube API 経由でアップロードできる動画数が制限されています。- クリエイターの所在地によっては、高度な機能へのアクセスを取得することで、チャンネルの 1 日あたりの制限を引き上げることができる場合があります。詳細は こちら の記事を参照してください。
- 制限は国/地域やチャンネル履歴によって異なる場合があります。著作権違反警告はチャンネル履歴の適格性に影響し、コミュニティガイドライン違反警告 はチャンネルがアップロードできる量に影響します。
説明欄のリンク
YouTube の動画の説明でクリック可能なリンクを持たせるには、YouTube Studio で Advanced Features を有効化する必要があります。 YouTube Studio -> Settings -> Channel -> Feature Eligibility -> Advanced Features -> Access Features に移動して、Advanced Features を有効化してください。
プレイリスト
youTubeOptions オブジェクトに playListId を含めることで、動画を YouTube プレイリストに追加できます。
認証済みユーザーとチャンネルがプレイリストの所有者であることを確認してください。
YouTube Playlist
動画の字幕/キャプション
SRT ファイル または YouTube SBV ファイル を含めることで、YouTube の字幕(YouTube キャプションとも呼ばれます)を動画に追加できます。SRT または SBV ファイルの URL を指定するには、youTubeOptions オブジェクトの subTitleUrl フィールドを使用します。
YouTube Subtitles
subTitleUrl: 有効な SRT または SBV ファイル。URL はhttps://で始まり、.srtまたは.sbvで終わる必要があり、有効な SRT または SBV ファイルである必要があります。ファイルは 100 MB 未満である必要があります。subTitleLanguage: 任意: 字幕の言語。有効な 言語コード である必要があります。デフォルト: “en”。subTitleName: 任意: キャプショントラックの名前。この名前は再生中のオプションとしてユーザーに表示されることを意図しています。サポートされる最大名前長は 150 文字です。デフォルト: “English”。
SRT および SBV ファイルとは?SRT (SubRip Subtitle) と SBV (YouTube SubViewer) は、動画のタイムテキストを表示するために使用される字幕ファイル形式です。主な違いは、SRT が HH:MM:SS,MS 形式でタイムスタンプに矢印セパレーターを使用するのに対し、SBV は HH:MM:SS.MS 形式でカンマを使用する点です。
タグ
youTubeOptions オブジェクトに tags 配列を含めることで、動画に YouTube タグを追加できます。
各タグは少なくとも 2 文字以上である必要があり、すべてのタグの合計長は 500 文字以下でなければなりません。
YouTube Tags
YouTube メンション
YouTube 投稿に@handle を追加することはできますが、YouTube は投稿テキスト内のメンションの解決をサポートしていません。
@handle はプレーンテキストのままとなります。
