The "liveBroadcasts" collection of methods.
Typical usage is:
$youtubeService = new Google_Service_YouTube(...);
$liveBroadcasts = $youtubeService->liveBroadcasts;
Table of Contents
-
$client
: Google_Client
-
$methods
: array<string|int, mixed>
-
$resourceName
: string
-
$rootUrl
: string
-
$serviceName
: string
-
$servicePath
: string
-
$stackParameters
: mixed
-
__construct()
: mixed
-
bind()
: Google_Service_YouTube_LiveBroadcast
- Bind a broadcast to a stream. (liveBroadcasts.bind)
-
call()
: Google_Http_Request|expectedClass
- TODO: This function needs simplifying.
-
control()
: Google_Service_YouTube_LiveBroadcast
- Slate and recording control of the live broadcast. Support actions: slate
on/off, recording start/stop/pause/resume. Design doc: goto/yt-api-
liveBroadcast-control (liveBroadcasts.control)
-
createRequestUri()
: string
- Parse/expand request parameters and create a fully qualified
request uri.
-
delete()
: mixed
- Delete a given broadcast. (liveBroadcasts.delete)
-
insert()
: Google_Service_YouTube_LiveBroadcast
- Inserts a new stream for the authenticated user. (liveBroadcasts.insert)
-
listLiveBroadcasts()
: Google_Service_YouTube_LiveBroadcastListResponse
- Retrieve the list of broadcasts associated with the given channel.
-
transition()
: Google_Service_YouTube_LiveBroadcast
- Transition a broadcast to a given status. (liveBroadcasts.transition)
-
update()
: Google_Service_YouTube_LiveBroadcast
- Updates an existing broadcast for the authenticated user.
-
convertToArrayAndStripNulls()
: mixed
$client
private
Google_Client
$client
$methods
private
array<string|int, mixed>
$methods
$resourceName
private
string
$resourceName
$rootUrl
private
string
$rootUrl
$serviceName
private
string
$serviceName
$servicePath
private
string
$servicePath
$stackParameters
private
mixed
$stackParameters
= array('alt' => array('type' => 'string', 'location' => 'query'), 'fields' => array('type' => 'string', 'location' => 'query'), 'trace' => array('type' => 'string', 'location' => 'query'), 'userIp' => array('type' => 'string', 'location' => 'query'), 'quotaUser' => array('type' => 'string', 'location' => 'query'), 'data' => array('type' => 'string', 'location' => 'body'), 'mimeType' => array('type' => 'string', 'location' => 'header'), 'uploadType' => array('type' => 'string', 'location' => 'query'), 'mediaUpload' => array('type' => 'complex', 'location' => 'query'), 'prettyPrint' => array('type' => 'string', 'location' => 'query'))
__construct()
public
__construct(mixed $service, mixed $serviceName, mixed $resourceName, mixed $resource) : mixed
Parameters
-
$service
: mixed
-
-
$serviceName
: mixed
-
-
$resourceName
: mixed
-
-
$resource
: mixed
-
Return values
mixed
—
bind()
Bind a broadcast to a stream. (liveBroadcasts.bind)
public
bind(string $id, string|array<string|int, mixed> $part[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcast
Parameters
-
$id
: string
-
Broadcast to bind to the stream
-
$part
: string|array<string|int, mixed>
-
The part parameter specifies a comma-separated
list of one or more liveBroadcast resource properties that the API response
will include. The part names that you can include in the parameter value are
id, snippet, contentDetails, and status.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string streamId Stream to bind, if not set unbind the current one.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
Return values
Google_Service_YouTube_LiveBroadcast
—
call()
TODO: This function needs simplifying.
public
call( $name, $arguments[, $expectedClass = null ]) : Google_Http_Request|expectedClass
Parameters
-
$name
:
-
-
$arguments
:
-
-
$expectedClass
:
= null
-
- optional, the expected class name
-
throws
-
Google_Exception
Return values
Google_Http_Request|expectedClass
—
control()
Slate and recording control of the live broadcast. Support actions: slate
on/off, recording start/stop/pause/resume. Design doc: goto/yt-api-
liveBroadcast-control (liveBroadcasts.control)
public
control(string $id, string|array<string|int, mixed> $part[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcast
Parameters
-
$id
: string
-
-
$part
: string|array<string|int, mixed>
-
The part parameter specifies a comma-separated
list of one or more liveBroadcast resource properties that the API response
will include. The part names that you can include in the parameter value are
id, snippet, contentDetails, and status.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
-
opt_param
-
string walltime The wall clock time at which the action should be
executed. Only one of offset_time_ms and walltime may be set at a time.
-
opt_param
-
string offsetTimeMs The exact time when the actions (e.g. slate
on) are executed. It is an offset from the first frame of the monitor stream.
If not set, it means "now" or ASAP. This field should not be set if the
monitor stream is disabled, otherwise an error will be returned.
-
opt_param
-
bool displaySlate Whether display or hide slate.
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
Return values
Google_Service_YouTube_LiveBroadcast
—
createRequestUri()
Parse/expand request parameters and create a fully qualified
request uri.
public
createRequestUri(string $restPath, array<string|int, mixed> $params) : string
Parameters
-
$restPath
: string
-
-
$params
: array<string|int, mixed>
-
-
static
-
Return values
string
—
delete()
Delete a given broadcast. (liveBroadcasts.delete)
public
delete(string $id[, array<string|int, mixed> $optParams = array() ]) : mixed
Parameters
-
$id
: string
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
Return values
mixed
—
insert()
Inserts a new stream for the authenticated user. (liveBroadcasts.insert)
public
insert(string|array<string|int, mixed> $part, Google_Service_YouTube_LiveBroadcast $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcast
Parameters
-
$part
: string|array<string|int, mixed>
-
The part parameter serves two purposes in this
operation. It identifies the properties that the write operation will set as
well as the properties that the API response will include. The part
properties that you can include in the parameter value are id, snippet,
contentDetails, and status.
-
$postBody
: Google_Service_YouTube_LiveBroadcast
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
Return values
Google_Service_YouTube_LiveBroadcast
—
listLiveBroadcasts()
Retrieve the list of broadcasts associated with the given channel.
public
listLiveBroadcasts(string|array<string|int, mixed> $part[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcastListResponse
(liveBroadcasts.listLiveBroadcasts)
Parameters
-
$part
: string|array<string|int, mixed>
-
The part parameter specifies a comma-separated
list of one or more liveBroadcast resource properties that the API response
will include. The part names that you can include in the parameter value are
id, snippet, contentDetails, status and statistics.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string broadcastType Return only broadcasts with the selected
type.
-
opt_param
-
string maxResults The maxResults parameter specifies the maximum
number of items that should be returned in the result set.
-
opt_param
-
string broadcastStatus Return broadcasts with a certain status,
e.g. active broadcasts.
-
opt_param
-
string pageToken The pageToken parameter identifies a specific
page in the result set that should be returned. In an API response, the
nextPageToken and prevPageToken properties identify other pages that could be
retrieved.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
-
opt_param
-
string id Return broadcasts with the given ids from Stubby or
Apiary.
-
opt_param
-
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
Return values
Google_Service_YouTube_LiveBroadcastListResponse
—
transition()
Transition a broadcast to a given status. (liveBroadcasts.transition)
public
transition(string $id, string $broadcastStatus, string|array<string|int, mixed> $part[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcast
Parameters
-
$id
: string
-
-
$broadcastStatus
: string
-
The status to which the broadcast is going to
transition.
-
$part
: string|array<string|int, mixed>
-
The part parameter specifies a comma-separated
list of one or more liveBroadcast resource properties that the API response
will include. The part names that you can include in the parameter value are
id, snippet, contentDetails, and status.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
Return values
Google_Service_YouTube_LiveBroadcast
—
update()
Updates an existing broadcast for the authenticated user.
public
update(string|array<string|int, mixed> $part, Google_Service_YouTube_LiveBroadcast $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_YouTube_LiveBroadcast
Parameters
-
$part
: string|array<string|int, mixed>
-
The part parameter serves two purposes in this
operation. It identifies the properties that the write operation will set as
well as the properties that the API response will include. The part
properties that you can include in the parameter value are id, snippet,
contentDetails, and status. Note that this method will override the existing
values for all of the mutable properties that are contained in any parts that
the parameter value specifies. For example, a broadcast's privacy status is
defined in the status part. As such, if your request is updating a private or
unlisted broadcast, and the request's part parameter value includes the
status part, the broadcast's privacy setting will be updated to whatever
value the request body specifies. If the request body does not specify a
value, the existing privacy setting will be removed and the broadcast will
revert to the default privacy setting.
-
$postBody
: Google_Service_YouTube_LiveBroadcast
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string onBehalfOfContentOwnerChannel This parameter can only be
used in a properly authorized request. Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel
parameter specifies the YouTube channel ID of the channel to which a video is
being added. This parameter is required when a request specifies a value for
the onBehalfOfContentOwner parameter, and it can only be used in conjunction
with that parameter. In addition, the request must be authorized using a CMS
account that is linked to the content owner that the onBehalfOfContentOwner
parameter specifies. Finally, the channel that the
onBehalfOfContentOwnerChannel parameter value specifies must be linked to the
content owner that the onBehalfOfContentOwner parameter specifies. This
parameter is intended for YouTube content partners that own and manage many
different YouTube channels. It allows content owners to authenticate once and
perform actions on behalf of the channel specified in the parameter value,
without having to provide authentication credentials for each separate
channel.
-
opt_param
-
string onBehalfOfContentOwner Note: This parameter is intended
exclusively for YouTube content partners. The onBehalfOfContentOwner
parameter indicates that the request's authorization credentials identify a
YouTube CMS user who is acting on behalf of the content owner specified in
the parameter value. This parameter is intended for YouTube content partners
that own and manage many different YouTube channels. It allows content owners
to authenticate once and get access to all their video and channel data,
without having to provide authentication credentials for each individual
channel. The CMS account that the user authenticates with must be linked to
the specified YouTube content owner.
Return values
Google_Service_YouTube_LiveBroadcast
—
convertToArrayAndStripNulls()
protected
convertToArrayAndStripNulls(mixed $o) : mixed
Parameters
-
$o
: mixed
-
Return values
mixed
—