Documentação - YouTube API

Introdução

Em 31 de dezembro de 2023, desenvolvi uma API simples para listar dados de canais no YouTube usando o Google Apps Script. O objetivo era carregar informações sobre um canal do YouTube, como sua URL, thumbnails, playlists, logo, descrição, palavras-chave e mais.

A API também permite listar vídeos de uma playlist específica e obter informações detalhadas sobre um vídeo, como título, descrição, visualizações e comentários.

Para maiores detalhes, consulte o artigo sobre esta API em Uma API para acessar os vídeos do Youtube com Google App Scripts

Propósito

Esta API foi projetada para construir uma plataforma de vídeos focada em cursos gratuitos de programação. A ideia é reunir as melhores playlists de canais do YouTube numa única plataforma, oferecendo uma ferramenta de estudo útil para quem deseja aprender programação.

Embora a estrutura da API tenha sido concluída, o frontend nunca foi desenvolvido. No entanto, decidi disponibilizar o código no GitHub, junto com esta documentação, para quem desejar utilizá-lo.

Instalação

O código fonte está disponível no GitHub. Para instalar e configurar a API, siga as instruções fornecidas no repositório.

A API oferece três endpoints principais, acessíveis via requisições GET.

Endpoints

channelId

Este endpoint retorna os dados de um canal do YouTube em formato JSON. Utilize um ID válido de canal como parâmetro.

Exemplo de endpoint:

https://script.google.com/macros/s/AKfycbzeVoiwWN-9WZQ5tFgkWRiIqtMrVVQA3U6ZOgbo2VvsqqRprooJczorGDDRChMT17V4/exec?channelId=@DevAprender

{
  "title": "Dev Aprender | Jhonatan de Souza",
  "url": "https://www.youtube.com/channel/UCm63tB8wsKOVvxoU4iMpS2A",
  "description": "Aqui você irá aprender...\n",
  "thumbnails": {...},
  "logo": "https://yt3.ggpht.com/VKuVrr...",
  "banner": "https://yt3.googleusercontent.com/We_8h...",
  "country": "BR",
  "keywords": "dev aprender...",
  "playlistsSize": 8,
  "playlists": ["PLnNURxKyyLIJ5ftIIYFLNNLyCmBx5uXYM",...],
  "publishedAt": "2018-10-07T21:24:04Z"
}

playlistId

Este endpoint retorna os dados de uma playlist, como título, descrição, thumbnails, e uma lista de vídeos.

Exemplo de endpoint:

https://script.google.com/macros/s/AKfycbzeVoiwWN-9WZQ5tFgkWRiIqtMrVVQA3U6ZOgbo2VvsqqRprooJczorGDDRChMT17V4/exec?playlistId=PLnNURxKyyLIJ5ftIIYFLNNLyCmBx5uXYM

{
  "playlistDetails": {
    "playlistId": "PLnNURxKyyLIKvXocwRwLCQqPU0mcTSLxJ",
    "playlistTitle": "CRIANDO UM APP DO ZERO...",
    "playlistDescription": "Veja como estou criando...",
    "playlistThumbnail": {...},
    "channelTitle": "Dev Aprender | Jhonatan de Souza",
    "channelDescription": "Aqui você irá aprender...\n",
    "totalViews": "19330643",
    "privacyStatus": "public",
    "playlistSize": 4
  },
  "playlistVideos": ["IftUFXo2e-k", "ctgSnU_laSI", "23MV2a3BYS0", "hCrQcg6sj4Q"]
}

videoId

Este endpoint retorna os dados de um vídeo específico, incluindo título, descrição, URL, thumbnails, visualizações e comentários.

Exemplo de endpoint:

https://script.google.com/macros/s/AKfycbzeVoiwWN-9WZQ5tFgkWRiIqtMrVVQA3U6ZOgbo2VvsqqRprooJczorGDDRChMT17V4/exec?videoId=IftUFXo2e-k

{
  "title": "APP Conversor de CRIPTO MOEDAS...",
  "url": "https://www.youtube.com/watch?v=IftUFXo2e-k",
  "description": "🔥Quer se TORNAR um PROGRAMADOR...",
  "thumbnails": {...},
  "viewCount": "9658",
  "commentCount": "145"
}

Considerações Finais

Este projeto é apenas um ponto de partida para quem deseja explorar e integrar dados do YouTube em seus próprios aplicativos. Espero que seja útil para outros desenvolvedores que buscam criar soluções inovadoras utilizando a API do YouTube.

Nota: O código está disponível no GitHub, e qualquer contribuição para melhorar ou expandir esta API será muito bem-vinda.

Código no github

Youtube API

Artigo completo sobre a API

Uma API para acessar os vídeos do Youtube com Google App Scripts