> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # YouTube API > YouTube API を使った投稿オプション YouTube への投稿には、YouTube アカウントに少なくとも 1 つのチャンネルがあり、あなたがそのチャンネルの所有者であることが必要です。 YouTube チャンネルを作成するには、YouTube ダッシュボードでプロファイルをクリックし、「チャンネルを作成」を選択します。 以下のリンクからも直接 YouTube チャンネルを作成できます: [http://m.youtube.com/create\_channel](http://m.youtube.com/create_channel) YouTube チャンネルの表示に問題がある場合は、[YouTube チャンネルトラブルシューティングガイド](/help-center/technical-support/youtube_channels_not_showing) を参照してください。 YouTube のアップロード失敗では、エラーコード **453**（タイムアウト）または **454** （サービス利用不可）が `retryAvailable: true` とともに返される場合があります。統合コードは このフラグを分岐して、一時的な失敗を自動的にバックオフ付きで再試行できます。 すべてのリストは [エラーコードリファレンス](/errors/errors-ayrshare) を参照してください。 詳細は [YouTube Media Guidelines](/media-guidelines/youtube) および [YouTube Authorization](/dashboard/connect-social-accounts/youtube) を参照してください。 ## YouTube への投稿 ### 投稿の概要 YouTube API を使った投稿には、`youTubeOptions` オブジェクトと少なくとも `title` パラメーター（最大 100 文字）が必要です。 `title` は必須の唯一のフィールドで、[transcribe エンドポイント](/apis/generate/transcribe-video) で自動生成することもできます。 たとえば、デフォルト設定で YouTube 動画を投稿する場合： ```json YouTube Post theme={"system"} { // 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 動画はデフォルトでは `private` ですが、公開範囲を `public` または `unlisted` に設定することもできます。 詳細は下記のオプションフィールドを参照してください。 ### YouTube 投稿のオプションフィールド 動画の `visibility`、`tags`、`publishAt` 日付など、他にもいくつかのオプションフィールドがあります。要件と説明については以下のコメントを参照してください。 ```json YouTube Post Optional Fields theme={"system"} { // Required fields "post": "My Best YouTube Description", // Video description, up to 5,000 characters "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", } } ``` **収益化とコンテンツ管理** `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 動画を投稿できます。 ```json YouTube Shorts Post theme={"system"} { "youTubeOptions": { "shorts": true } } ``` #shorts ハッシュタグが YouTube の説明に追加されます。 ### YouTube Shorts に関する重要な情報 ## YouTube サムネイル カスタムサムネイルには **認証済みの YouTube チャンネル** が必要です。動画は投稿されるがサムネイルが適用されない最も一般的な原因は、認証されていないチャンネルです。[https://www.youtube.com/verify](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)](/help-center/technical-support/youtube_thumbnail_unverified_channel) を参照してください。 ### YouTube サムネイルの追加 YouTube サムネイルや、15 分の動画のアップロードなどの他の機能を使用するには、電話番号の認証が必要です。 `thumbNail` は、JPEG または PNG の URL で 2MB 未満のサイズです。ファイル拡張子は png、jpg、jpeg のいずれかで終わる必要があります。 ```json YouTube Thumbnail theme={"system"} { "youTubeOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` YouTube Shorts は現在サムネイルをサポートしていません。 ### YouTube Studio でサムネイルを有効にする サムネイルを投稿するには、YouTube から権限を付与されている必要があります。[YouTube Studio](https://studio.youtube.com/) で *Settings->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. まだ問題が解決しない場合は、[サムネイル問題の解決](https://www.youtube.com/watch?v=1bFmX2uQk0Y) の動画を参照してください。 ## 動画: API 経由での YouTube への投稿