Moodle PHP Documentation 4.3
Moodle 4.3.5 (Build: 20240610) (7dcfaa79f78)
Google_Service_YouTube_Channels_Resource Class Reference

The "channels" collection of methods. More...

Inheritance diagram for Google_Service_YouTube_Channels_Resource:
Google_Service_Resource

Public Member Functions

 call ($name, $arguments, $expected_class=null)
 TODO: This function needs simplifying.
 
 listChannels ($part, $optParams=array())
 Returns a collection of zero or more channel resources that match the request criteria.
 
 update ($part, Google_Service_YouTube_Channel $postBody, $optParams=array())
 Updates a channel's metadata.
 

Protected Member Functions

 convertToArrayAndStripNulls ($o)
 

Detailed Description

The "channels" collection of methods.

Typical usage is: $youtubeService = new Google_Service_YouTube(...); $channels = $youtubeService->channels;

Member Function Documentation

◆ call()

Google_Service_Resource::call ( $name,
$arguments,
$expected_class = null )
inherited

TODO: This function needs simplifying.

Parameters
$name
$arguments
$expected_class- optional, the expected class name
Return values
Google_Http_Request|expected_class
Exceptions
Google_Exception

◆ listChannels()

Google_Service_YouTube_Channels_Resource::listChannels ( $part,
$optParams = array() )

Returns a collection of zero or more channel resources that match the request criteria.

(channels.listChannels)

Parameters
string$partThe part parameter specifies a comma-separated list of one or more channel resource properties that the API response will include.

If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a channel resource, the contentDetails property contains other properties, such as the uploads properties. As such, if you set part=contentDetails, the API response will also contain all of those nested properties.

Parameters
array$optParamsOptional parameters.

@opt_param bool managedByMe Note: This parameter is intended exclusively for YouTube content partners.

Set this parameter's value to true to instruct the API to only return channels managed by the content owner that the onBehalfOfContentOwner parameter specifies. The user must be authenticated as a CMS account linked to the specified content owner and onBehalfOfContentOwner must be provided. @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 forUsername The forUsername parameter specifies a YouTube username, thereby requesting the channel associated with that username. @opt_param bool mine Set this parameter's value to true to instruct the API to only return channels owned by the authenticated user. @opt_param string maxResults The maxResults parameter specifies the maximum number of items that should be returned in the result set. @opt_param string id The id parameter specifies a comma-separated list of the YouTube channel ID(s) for the resource(s) that are being retrieved. In a channel resource, the id property specifies the channel's YouTube channel ID. @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 bool mySubscribers Use the subscriptions.list method and its mySubscribers parameter to retrieve a list of subscribers to the authenticated user's channel. @opt_param string hl The hl parameter should be used for filter out the properties that are not in the given language. Used for the brandingSettings part. @opt_param string categoryId The categoryId parameter specifies a YouTube guide category, thereby requesting YouTube channels associated with that category.

Return values
Google_Service_YouTube_ChannelListResponse

◆ update()

Google_Service_YouTube_Channels_Resource::update ( $part,
Google_Service_YouTube_Channel $postBody,
$optParams = array() )

Updates a channel's metadata.

Note that this method currently only supports updates to the channel resource's brandingSettings and invideoPromotion objects and their child properties. (channels.update)

Parameters
string$partThe 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 API currently only allows the parameter value to be set to either brandingSettings or invideoPromotion. (You cannot update both of those parts with a single request.)

Note that this method overrides the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies.

Parameters
Google_Channel$postBody
array$optParamsOptional parameters.

@opt_param string onBehalfOfContentOwner The onBehalfOfContentOwner parameter indicates that the authenticated user 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 actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner.

Return values
Google_Service_YouTube_Channel

The documentation for this class was generated from the following file: