YouTube API

​

Posten auf YouTube

​

Überblick zum Posten

{
  // 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"
  }
}

​

Optionale Felder für YouTube-Beiträge

{
  // 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",
  }
}

• Der title darf maximal 100 Zeichen umfassen. Der post darf maximal 5.000 Zeichen umfassen. post und title dürfen beliebige Zeichen außer < und > enthalten.
• Die Playlist-ID finden Sie, indem Sie die Playlist im Browser öffnen und den Wert nach list= kopieren. Der authentifizierte Nutzer und Kanal muss Eigentümer der Playlist sein, um Videos hinzuzufügen.
• Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter isVideo. Weitere Informationen finden Sie unter /post-Endpunkt.
• Das Feld publishAt erlaubt es YouTube, die Veröffentlichungszeit zu steuern. Das Video ist bis zum Veröffentlichungszeitpunkt privat und wird dann öffentlich gemacht. Liegt die Veröffentlichungszeit in der Vergangenheit, wird das Video sofort öffentlich gemacht. Verwenden Sie das Feld scheduleDate des Beitrags nicht zusammen mit dem Feld publishAt.
• Das Feld containsSyntheticMedia wird verwendet, um offenzulegen, dass ein Video realistische veränderte oder synthetische (A/S) Inhalte enthält: eine reale Person so darzustellen, als würde sie etwas sagen oder tun, was sie tatsächlich nicht gesagt oder getan hat, Aufnahmen eines realen Ereignisses oder Ortes zu verändern oder eine realistisch wirkende Szene zu erzeugen, die tatsächlich nicht stattgefunden hat.
• license – Legt den Lizenztyp des Videos fest. Zulässige Werte: "youtube" (Standard YouTube-Lizenz, Standard) oder "creativeCommon" (Creative Commons – Namensnennung).
• embeddable – Boolean (oder die Strings "true" / "false"). Steuert, ob das Video auf Websites von Drittanbietern eingebettet werden darf. Standard: true.
• publicStatsViewable – Boolean (oder die Strings "true" / "false"). Steuert, ob das erweiterte Statistik-Panel auf der Watch-Seite des Videos öffentlich sichtbar ist. Die grundlegenden Aufruf- und Like-Zahlen bleiben unabhängig von dieser Einstellung öffentlich sichtbar. Standard: true. Details finden Sie unter status.publicStatsViewable in der YouTube-Data-API-Referenz.
• Weitere Informationen finden Sie unter YouTube-Medienrichtlinien.

​

YouTube Shorts

​

YouTube Shorts posten

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

​

Wichtige Informationen zu YouTube Shorts

• Ein Video als Short zu senden ist ein Hinweis an YouTube, dass Sie möchten, dass das Video als Short erscheint, garantiert aber nicht, dass es tatsächlich als Short erscheint. Das Video muss die Anforderungen für Short-Videos erfüllen, z. B. eine Länge von maximal 3 Minuten und ein vertikales Seitenverhältnis von 9:16, um von YouTube als Short berücksichtigt zu werden.
• YouTube Shorts unterstützen keine Thumbnails.
• Zusätzliche Informationen zur API zum Posten von YouTube Shorts.

​

YouTube-Thumbnails

​

YouTube-Thumbnails hinzufügen

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

​

Thumbnails in YouTube Studio aktivieren

​

Video: Posten auf YouTube über die API

​

Upload-Limits

• Je nach Standort eines Creators kann ein Kanal möglicherweise sein tägliches Limit erhöhen, indem er Zugriff auf erweiterte Funktionen erhält. Mehr dazu erfahren Sie in diesem Artikel.
• Limits können je nach Land/Region oder Kanalverlauf variieren. Copyright-Strikes können die Berechtigung des Kanalverlaufs beeinträchtigen, und Community-Richtlinien-Strikes wirken sich darauf aus, wie viel ein Kanal hochladen kann.

​

Beschreibungs-Links

​

Playlists

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

​

Untertitel/Captions für Videos

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

• subTitleUrl: Eine gültige SRT- oder SBV-Datei. Die URL muss mit https:// beginnen und mit .srt oder .sbv enden und eine gültige SRT- oder SBV-Datei sein. Die Datei muss kleiner als 100 MB sein.
• subTitleLanguage: Optional: Die Sprache der Untertitel. Muss ein gültiger Sprachcode sein. Standard: „en”.
• subTitleName: Optional: Der Name der Untertitelspur. Der Name wird dem Nutzer als Auswahl während der Wiedergabe angezeigt. Maximal 150 Zeichen unterstützt. Standard: „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.

​

Tags

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

​

YouTube-Erwähnungen

​

Zeichenbeschränkungen

​

Zusätzliche Endpunkte