API de YouTube

​

Publicar en YouTube

​

Descripción general de la publicación

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

​

Campos opcionales de la publicación en YouTube

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

• El title debe tener 100 caracteres o menos. El post debe tener 5000 caracteres o menos. post y title pueden contener cualquier carácter excepto < y >.
• El Playlist Id se puede encontrar abriendo la playlist en un navegador y copiando el valor después de list=. El usuario autenticado y el canal deben ser propietarios de la playlist para poder agregar videos.
• Si tu video no termina con una extensión de video conocida como mp4, usa el parámetro isVideo. Consulta el endpoint /post para más detalles.
• El campo publishAt permite que YouTube controle el momento de la publicación. El video estará en modo privado hasta la hora de publicación, momento en el que se hará público. Si la hora de publicación es en el pasado, el video se hará público de inmediato. No uses el campo scheduleDate de la publicación cuando uses el campo publishAt.
• El campo containsSyntheticMedia se usa para declarar que un video contiene contenido realista Altered o Synthetic (A/S): hacer que una persona real parezca decir o hacer algo que en realidad no dijo o hizo, alterar imágenes de un evento o lugar real, o generar una escena de apariencia realista que en realidad no ocurrió.
• license — establece el tipo de licencia del video. Valores aceptados: "youtube" (Standard YouTube License, por defecto) o "creativeCommon" (Creative Commons - Attribution).
• embeddable — Boolean (o las cadenas "true" / "false"). Controla si el video se puede embeber en sitios web de terceros. Por defecto: true.
• publicStatsViewable — Boolean (o las cadenas "true" / "false"). Controla si el panel de estadísticas extendidas en la página de reproducción del video es visible públicamente. El conteo básico de vistas y de likes sigue siendo visible públicamente independientemente de esta configuración. Por defecto: true. Consulta status.publicStatsViewable en la referencia de YouTube Data API para más detalles.
• Consulta las Directrices de medios de YouTube para más información.

​

YouTube Shorts

​

Publicar YouTube Shorts

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

​

Información importante sobre YouTube Shorts

• Enviar un video como Short es una indicación a YouTube de que te gustaría que el video apareciera como Short, pero no garantiza que aparezca como Short. El video debe cumplir con los requisitos de video Short, como tener una duración de 3 minutos o menos y una relación de aspecto vertical 9:16 para que YouTube lo considere un Short.
• Los YouTube Shorts no admiten miniaturas.
• Más información sobre cómo usar la API para publicar YouTube Shorts.

​

Miniaturas de YouTube

​

Agregar miniaturas de YouTube

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

​

Habilitar miniaturas en YouTube Studio

​

Video: publicar en YouTube mediante la API

​

Límites de subida

• Dependiendo de la ubicación del creador, un canal podría aumentar su límite diario obteniendo acceso a funciones avanzadas. Para más información visita este artículo.
• Los límites pueden variar según país/región o historial del canal. Las advertencias por copyright pueden afectar la elegibilidad del historial del canal y las strikes de Community Guidelines afectarán cuánto puede subir un canal.

​

Enlaces en la descripción

​

Playlists

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

​

Subtítulos/captions para videos

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

• subTitleUrl: archivo SRT o SBV válido. La URL debe comenzar con https:// y terminar en .srt o .sbv y ser un archivo SRT o SBV válido. El archivo debe pesar menos de 100 MB.
• subTitleLanguage: opcional: idioma de los subtítulos. Debe ser un código de idioma válido. Por defecto: “en”.
• subTitleName: opcional: nombre de la pista de subtítulos. El nombre está pensado para ser visible para el usuario como opción durante la reproducción. La longitud máxima admitida es de 150 caracteres. Por defecto: “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"]
  }
}

​

Menciones en YouTube

​

Límites de caracteres

​

Endpoints adicionales