Les exemples suivants montrent comment utiliser l'API YouTube Live Streaming pour créer et gérer des diffusions et des flux en direct.
Créer une diffusion
Appelez la méthode liveBroadcasts.insert pour planifier un nouvel événement en direct. Le corps de la requête doit définir le titre de la diffusion, l'heure de début planifiée et l'état de confidentialité. Vous pouvez également spécifier la catégorie de la vidéo à l'aide de la propriété snippet.categoryId. Vous pouvez récupérer une liste de catégories à l'aide de la méthode videoCategories.list.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert? part=snippet,status
Le corps de la requête contient une ressource liveBroadcast. Dans cet exemple, le corps de la requête est le suivant :
{
"snippet": {
"title": "My Live Event",
"scheduledStartTime": "2026-10-30T19:00:00Z",
"categoryId": "17"
},
"status": {
"privacyStatus": "unlisted"
}
}Créer un flux
Appelez la méthode liveStreams.insert pour créer un flux qui définit les paramètres de transmission de votre vidéo. Vous devez spécifier le titre du flux et ses paramètres de CDN (type d'ingestion, résolution et fréquence d'images).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert? part=snippet,cdn
Le corps de la requête contient une ressource liveStream. Dans cet exemple, le corps de la requête est le suivant :
{
"snippet": {
"title": "My Live Stream"
},
"cdn": {
"frameRate": "30fps",
"ingestionType": "rtmp",
"resolution": "720p"
}
}Associer une diffusion à un flux
Appelez la méthode liveBroadcasts.bind pour associer votre diffusion à votre flux. Définissez le paramètre id sur l'ID de la diffusion et le paramètre de requête streamId sur l'ID du flux.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind? id=BROADCAST_ID &streamId=STREAM_ID &part=id,snippet
Changer l'état d'une diffusion
Appelez la méthode liveBroadcasts.transition pour modifier l'état de votre diffusion. Par exemple, pour commencer les tests, définissez l'état sur testing. Pour lancer la diffusion proprement dite, définissez l'état sur live.
Cet exemple définit la diffusion sur testing. Définissez le paramètre id sur l'ID de la diffusion et le paramètre broadcastStatus sur testing.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition? broadcastStatus=testing &id=BROADCAST_ID &part=id,status
Récupérer des diffusions
Appelez la méthode liveBroadcasts.list pour récupérer des diffusions. Vous pouvez filtrer par broadcastStatus (par exemple, active, completed, upcoming) ou récupérer vos propres diffusions à l'aide du paramètre mine.
Cet exemple récupère les diffusions à venir de l'utilisateur authentifié.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list? part=snippet,status &broadcastStatus=upcoming &mine=true