API do YouTube

​

Publicando no YouTube

​

Visão geral da publicação

{
  // 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 opcionais da publicação no 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",
  }
}

• O title deve ter 100 caracteres ou menos. O post deve ter 5.000 caracteres ou menos. O post e o title podem conter quaisquer caracteres, exceto < e >.
• O Playlist Id pode ser encontrado abrindo a playlist em um navegador e copiando o valor após list=. O usuário autenticado e o canal devem ser os proprietários da playlist para adicionar vídeos.
• Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro isVideo. Consulte o endpoint /post para detalhes.
• O campo publishAt permitirá que o YouTube controle o horário de publicação. O vídeo permanecerá privado até o horário de publicação, quando será tornado público. Se o horário de publicação estiver no passado, o vídeo será tornado público imediatamente. Não use o campo scheduleDate de post quando estiver usando o campo publishAt.
• O campo containsSyntheticMedia é usado para divulgar que um vídeo contém conteúdo realista Alterado ou Sintético (A/S): faz uma pessoa real parecer dizer ou fazer algo que ela realmente não disse nem fez, altera imagens de um evento ou local real, ou gera uma cena com aparência realista que não ocorreu de fato.
• license - Define o tipo de licença do vídeo. Valores aceitos: "youtube" (Licença padrão do YouTube, padrão) ou "creativeCommon" (Creative Commons - Attribution).
• embeddable - Booleano (ou as strings "true" / "false"). Controla se o vídeo pode ser incorporado em sites de terceiros. Padrão: true.
• publicStatsViewable - Booleano (ou as strings "true" / "false"). Controla se o painel de estatísticas estendidas na página de reprodução do vídeo é visível publicamente. A contagem básica de visualizações e likes permanece publicamente visível independentemente desta configuração. Padrão: true. Consulte status.publicStatsViewable na referência da YouTube Data API para detalhes.
• Consulte as Diretrizes de mídia do YouTube para mais informações.

​

YouTube Shorts

​

Publicando YouTube Shorts

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

​

Informações importantes sobre YouTube Shorts

• Enviar um vídeo como Short é uma indicação ao YouTube de que você gostaria que o vídeo aparecesse como Short, mas não garante que ele apareça como Short. O vídeo deve atender aos requisitos de Short video, como ter 3 minutos ou menos e proporção vertical de 9:16 para ser considerado Short pelo YouTube.
• YouTube Shorts não suportam thumbnails.
• Informações adicionais sobre uso da API para publicar YouTube Shorts.

​

Thumbnails do YouTube

​

Adicionando thumbnails do YouTube

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

​

Habilitar thumbnails no YouTube Studio

​

Vídeo: Publicando no YouTube via API

​

Limites de upload

• Dependendo da localização de um criador, um canal pode conseguir aumentar seu limite diário obtendo acesso a recursos avançados. Para saber mais, acesse este artigo.
• Os limites podem variar por país/região ou histórico do canal. Notificações de violação de direitos autorais podem afetar a elegibilidade do histórico do canal, e notificações das Diretrizes da Comunidade afetarão o quanto um canal pode fazer upload.

​

Links na descrição

​

Playlists

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

​

Legendas / Captions para vídeos

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

• subTitleUrl: Um arquivo SRT ou SBV válido. A URL deve começar com https:// e terminar em .srt ou .sbv e ser um arquivo SRT ou SBV válido. O arquivo deve ter menos de 100 MB.
• subTitleLanguage: Opcional: O idioma das legendas. Deve ser um código de idioma válido. Padrão: “en”.
• subTitleName: Opcional: O nome da faixa de legenda. O nome se destina a ficar visível para o usuário como opção durante a reprodução. O tamanho máximo suportado é de 150 caracteres. Padrão: “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"]
  }
}

​

Menções no YouTube

​

Limites de caracteres

​

Endpoints adicionais