Once created, a liveStream resource can be bound to exactly one liveBroadcast resource. The stream provides the content that will be broadcast to YouTube users. And after creating the broadcast using the Live Streaming API, you can use the YouTube Data API to provide additional metadata about the video.Ĭontains information about the video stream that you are transmitting to YouTube. In fact, the liveBroadcast resource and the video resource share the same ID. As such, a liveBroadcast resource corresponds to exactly one YouTube video resource.
A liveBroadcast resource is an extension of a YouTube video resource and sets video metadata that would be pertinent to a live broadcast but not to other YouTube videos. ResourcesĬontains information about an event that you are broadcasting on YouTube. However, the liveBroadcast, liveStream, and liveCuepoint resources are only used to create and manage live events. Technically, all of these resources are actually defined as part of either the YouTube Data API or the YouTube Content ID API. The table below describes the different types of resources that you will interact with using the Live Streaming API. Resources and resource typesĪ resource is an individual data entity with a unique identifier. Calling the Content ID API The API request must be authorized by a Google Account that is linked to the content owner that owns the broadcasting YouTube channel. Calling the Data API The API request must be authorized by the Google Account that owns the broadcasting YouTube channel. This section explains the authorization requirements for requests to the Content ID API, which are different from the requirements for authorizing other Live Streaming API requests. (A live video broadcast is an example of an asset.) The API also lets you claim videos and set ad policies for your videos. You can use the Content ID API to provide YouTube with metadata, ownership information, and policy information for your assets. For more information, see .Īs noted above, the Live Streaming API uses functionality that is technically part of either the YouTube Data API or the YouTube Content ID API. JSON is a common, language-independent data format that provides a simple text representation of arbitrary data structures. In the list of APIs, make sure the status is ON for the YouTube Data API v3 and, if you are a YouTube Content Partner, the YouTube Content ID API.įamiliarize yourself with the core concepts of the JSON (JavaScript Object Notation) data format. Go to the API Console and select the project that you just registered.Register your application with Google so that it can submit API requests.Īfter registering your application, select the YouTube Data API as one of the services that your application uses: You need a Google Account to access the Google API Console, request an API key, and register your application. Simplify transitions between broadcast states ( testing, live, etc.) and enable users to insert cuepoints. Your application could enable users to predefine broadcast settings and then select the settings to apply to a particular broadcast.Įnable broadcasters to define information about a broadcast and its video (using the YouTube Data API) at the same time. Schedule broadcasts and define broadcast settings. The list below suggests several ways to use the API in your application: cuepoints A cuepoint represents an ad break that can be inserted into a live broadcast. Each broadcast is associated with one video stream. streams A stream identifies the audio-video content that is being communicated to YouTube. Broadcasts can also be recorded and saved as YouTube videos so that users can watch them after they happen. Core concepts broadcasts A broadcast represents an event that can be watched on YouTube as it happens. It also provides an overview of the different functions that the API supports. It explains basic concepts of YouTube and of the API itself. This document is intended for developers who want to write applications to facilitate live broadcasting on YouTube. However, all of the resources that make up the Live Streaming API are used only to create and manage live events. The Data API enables YouTube users to manage their YouTube accounts, while the YouTube Content ID API enables interactions with YouTube's rights management system. The Live Streaming API is actually comprised of components of the YouTube Data API and the YouTube Content ID API. Using the API, you can schedule events (broadcasts) and associate them with video streams, which represent the actual broadcast content. The YouTube Live Streaming API lets you create, update, and manage live events on YouTube.