YouTube API

​

YouTube への投稿

​

投稿の概要

{
  // Required: Video description
  "post": "My Best YouTube Description", // empty string is allowed

  // Required: Platform to post to
  "platforms": ["youtube"],

  // Required: URL of video (only 1 allowed)
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],

  "youTubeOptions": {
    // Required: Video title (max 100 characters)
    "title": "Your Best Title"
  }
}

​

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

{
  // Required fields
  "post": "My Best YouTube Description", // Video description, up to 5,000 bytes
  "platforms": ["youtube"], // Platform to post to
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"], // URL of video (1 allowed)

  "youTubeOptions": {
    // Required fields
    "title": "Your Best Title", // Video Title (max 100 characters)

    /** Optional Fields **/

    // Visibility: "public", "unlisted", or "private" (default: "private")
    "visibility": "private",

    // Thumbnail settings - JPEG/PNG URL under 2MB, must end in png/jpg/jpeg
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg",

    // Video organization
    "playListId": "PLrav6EfwgDX5", // Playlist ID to add the video
    "tags": ["dancing", "dogs"], // Tag array (400 chars total, 2+ chars each)

    // Video settings
    "madeForKids": false, // Self-declared kids content (default: false)
    "license": "youtube", // "youtube" (default) or "creativeCommon"
    "embeddable": true, // default: true
    "publicStatsViewable": true, // default: true
    "shorts": true, // Post as YouTube Short (max 3 minutes, adds #shorts)
    "notifySubscribers": true, // Send notification to subscribers (default: true)
    "categoryId": 24, // Video category (24 = Entertainment)
    "containsSyntheticMedia": true, // Disclose that a video contains realistic Altered or Synthetic (A/S) content

    // YouTube controlled publishing - UTC publish time. See below for details.
    "publishAt": "2022-10-08T21:18:36Z",
  }
}

• title は 100 Unicode コードポイント以下にする必要があります。post は 5,000 バイト以下にする必要があります。YouTube は < と > を受け付けないため、Ayrshare は送信前にそれぞれ [ と ) に置き換えます。
• Playlist Id は、プレイリストをブラウザで開き、list= の後の値をコピーすることで取得できます。動画を追加するには、認証済みユーザーとチャンネルがプレイリストの所有者である必要があります。
• 動画が mp4 などの既知の動画拡張子で終わらない場合、isVideo パラメーターを使用してください。詳細は /post エンドポイント を参照してください。
• publishAt フィールドを指定すると、YouTube が公開時刻を制御できるようになります。 動画は公開時刻までプライベートとなり、その時刻に公開されます。 公開時刻が過去の場合、動画はすぐに公開されます。 publishAt フィールドを使用する際は、投稿の scheduleDate フィールドを使用しないでください。
• containsSyntheticMedia フィールドは、動画がリアリスティックに改変・合成された (A/S) コンテンツを含むことを開示するために使用します。具体的には、実在の人物が実際には言っていない・していないことを言ったり行ったりしているように見せる、実際の出来事や場所の映像を改変する、実際には起こらなかったリアリスティックに見えるシーンを生成する、などです。AI コンテンツの開示 を参照してください。
• license — 動画のライセンスタイプを設定します。受け付ける値: "youtube"（標準 YouTube ライセンス、デフォルト）または "creativeCommon"（Creative Commons - Attribution）。
• embeddable — ブール値（または文字列 "true" / "false"）。サードパーティのウェブサイトに動画を埋め込めるかを制御します。デフォルト: true。
• publicStatsViewable — ブール値（または文字列 "true" / "false"）。動画の視聴ページにある 拡張統計パネル が公開閲覧可能かを制御します。基本的な再生回数といいね数は、この設定に関わらず引き続き公開表示されます。デフォルト: true。詳細は YouTube Data API リファレンスの status.publicStatsViewable を参照してください。
• 詳細は YouTube Media Guidelines を参照してください。

​

AI コンテンツの開示

{
  "post": "Generated with a little help from a model",
  "platforms": ["youtube"],
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],
  "youTubeOptions": {
    "title": "Your Best Title",
    "containsSyntheticMedia": true
  }
}

• containsSyntheticMedia: 動画がリアリスティックに改変・合成されたコンテンツを含むことを開示するために true に設定する boolean。デフォルトは false です。このパラメータを省略すると、 Ayrshare はアップロード時に開示を送信しません。ただし、YouTube が独自にラベルを適用する場合があります (下記参照)。
• YouTube は、動画が次のいずれかに該当する場合に開示を求めています: 実在の人物が実際には言っていない・ していないことを言ったり行ったりしているように見せる、実際の出来事や場所の映像を改変する、 または実際には起こらなかったリアリスティックに見えるシーンを生成する。
• 開示が有効になるのは true と “true” のみです。それ以外の値 (false、“yes”、1 など) では開示は送信されず、 警告も返されません。
• YouTube Studio の動画の詳細ページにある AI use (AI の使用) の質問が Yes (はい) に設定されるため、公開後にそこで確認できます。
• このパラメータは自己開示のみを目的としたもので、ラベルが表示される唯一の方法ではありません。 Ayrshare はメディアが AI 生成かどうかを検出したり推測したりしません。YouTube は、たとえば自社の GenAI ツールで作成されたコンテンツや C2PA Content Credentials を含むファイルなどに対して、独自に動画へ ラベルを付ける場合もあります。

​

YouTube Shorts

​

YouTube Shorts の投稿

{
  "youTubeOptions": {
    "shorts": true
  }
}

​

YouTube Shorts に関する重要な情報

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

​

YouTube サムネイル

​

YouTube サムネイルの追加

{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

​

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

​

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

​

アップロード制限

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

​

説明欄のリンク

​

プレイリスト

{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}

​

動画の字幕／キャプション

{
  "youTubeOptions": {
    "title": "My new post from Ayrshare to Youtube",
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}

• subTitleUrl: 有効な SRT または SBV ファイル。URL は https:// で始まり、.srt または .sbv で終わる必要があり、有効な SRT または SBV ファイルである必要があります。ファイルは 100 MB 未満である必要があります。
• subTitleLanguage: 任意: 字幕の言語。有効な 言語コード である必要があります。デフォルト: “en”。
• subTitleName: 任意: キャプショントラックの名前。この名前は再生中のオプションとしてユーザーに表示されることを意図しています。サポートされる最大名前長は 150 文字です。デフォルト: “English”。

## SRT Format Example
1
00:00:01,000 --> 00:00:04,000
Welcome to our tutorial on subtitle formats.

2
00:00:04,500 --> 00:00:08,000
Today we'll learn about SRT and SBV files.

## SBV Format Example
0:00:01.000,0:00:04.000
Welcome to our tutorial on subtitle formats.

0:00:04.500,0:00:08.000
Today we'll learn about SRT and SBV files.

​

タグ

{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}

​

YouTube メンション

​

文字数制限

​

追加のエンドポイント