メインコンテンツへスキップ
YouTube への投稿には、YouTube アカウントに少なくとも 1 つのチャンネルがあり、あなたがそのチャンネルの所有者であることが必要です。 YouTube チャンネルを作成するには、YouTube ダッシュボードでプロファイルをクリックし、「チャンネルを作成」を選択します。 以下のリンクからも直接 YouTube チャンネルを作成できます: http://m.youtube.com/create_channelYouTube チャンネルの表示に問題がある場合は、YouTube チャンネルトラブルシューティングガイド を参照してください。
YouTube のアップロード失敗では、エラーコード 453(タイムアウト)または 454 (サービス利用不可)が retryAvailable: true とともに返される場合があります。統合コードは このフラグを分岐して、一時的な失敗を自動的にバックオフ付きで再試行できます。 すべてのリストは エラーコードリファレンス を参照してください。
詳細は YouTube Media Guidelines および YouTube Authorization を参照してください。

YouTube への投稿

投稿の概要

YouTube API を使った投稿には、youTubeOptions オブジェクトと少なくとも title パラメーター(最大 100 文字)が必要です。 title は必須の唯一のフィールドで、transcribe エンドポイント で自動生成することもできます。 たとえば、デフォルト設定で YouTube 動画を投稿する場合:
YouTube Post
YouTube 動画はデフォルトでは private ですが、公開範囲を public または unlisted に設定することもできます。 詳細は下記のオプションフィールドを参照してください。

YouTube 投稿のオプションフィールド

動画の visibilitytagspublishAt 日付など、他にもいくつかのオプションフィールドがあります。要件と説明については以下のコメントを参照してください。
YouTube Post Optional Fields
  • title は 100 文字以下にする必要があります。post は 5,000 文字以下にする必要があります。posttitle には < と > を除く任意の文字を含めることができます。
  • 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 を参照してください。
収益化とコンテンツ管理madeForKidslicenseembeddablepublicStatsViewable の各フィールドは、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
#shorts ハッシュタグが YouTube の説明に追加されます。

YouTube Shorts に関する重要な情報

  • 動画を Short として送信することは、その動画を Short として表示したいという意図を YouTube に伝えるだけであり、Short として表示されることを保証するものではありません。動画は Short 動画 の要件(3 分以内、縦向きアスペクト比 9:16 など)を満たす必要があり、YouTube によって Short として認識されます。
  • YouTube Shorts はサムネイルをサポートしていません。
  • API を使った YouTube Shorts の投稿 についての追加情報。

YouTube サムネイル

カスタムサムネイルには 認証済みの YouTube チャンネル が必要です。動画は投稿されるがサムネイルが適用されない最も一般的な原因は、認証されていないチャンネルです。https://www.youtube.com/verify で電話番号による認証を行ってください。thumbNailPNG または JPG/JPEG2MB 以下到達可能な 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 Shorts は現在サムネイルをサポートしていません。

YouTube Studio でサムネイルを有効にする

サムネイルを投稿するには、YouTube から権限を付与されている必要があります。YouTube StudioSettings->Channel に移動します。「Feature Eligibility」を選択し、「Features that require phone verification」をクリックします。電話番号を入力して有効化します。 YouTube Studio
YouTube では、電話番号を認証してからサムネイルが有効になるまで最大 24 時間かかる場合があります。YouTube はサムネイル追加の適格性を判断します。「Enabled」となっていても、YouTube がサムネイルのアップロードを許可することは保証されません。24 時間認証済みでもまだ問題がある場合、以下を確認してください:
  1. YouTube Studio でサムネイルを手動アップロードできること。
  2. Brand Content Owner アカウント(ビジネスまたは組織のチャンネルによく使用される)で作業している場合、必要な権限があることを確認してください。「Owner」権限を推奨します。
  3. まだ問題が解決しない場合は、サムネイル問題の解決 の動画を参照してください。

動画: API 経由での YouTube への投稿

アップロード制限

YouTube では、24 時間以内にチャンネルが YouTube API 経由でアップロードできる動画数が制限されています。
  • クリエイターの所在地によっては、高度な機能へのアクセスを取得することで、チャンネルの 1 日あたりの制限を引き上げることができる場合があります。詳細は こちら の記事を参照してください。
  • 制限は国/地域やチャンネル履歴によって異なる場合があります。著作権違反警告はチャンネル履歴の適格性に影響し、コミュニティガイドライン違反警告 はチャンネルがアップロードできる量に影響します。
アップロード制限エラーを受け取った場合は、24 時間待ってから再試行してください。

説明欄のリンク

YouTube の動画の説明でクリック可能なリンクを持たせるには、YouTube Studio で Advanced Features を有効化する必要があります。 YouTube Studio -> Settings -> Channel -> Feature Eligibility -> Advanced Features -> Access Features に移動して、Advanced Features を有効化してください。 YouTube Feature Eligibility

プレイリスト

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 はプレーンテキストのままとなります。

文字数制限

詳細については YouTube Character Limits を参照してください。

追加のエンドポイント

YouTube カテゴリを取得

YouTube ウォーターマークを設定

YouTube ウォーターマークを削除