API Documentation

Gdata/YouTube.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Gdata  
subpackage
YouTube  
version
$Id: YouTube.php 23775 2011-03-01 17:25:24Z ralph $  

\Zend_Gdata_YouTube

Service class for interacting with the YouTube Data API.

As the Google data API protocol is based upon the Atom Publishing Protocol (APP), Gdata functionality extends the appropriate Zend_Gdata_App classes

Extends from
\Zend_Gdata_Media
category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
link
http://code.google.com/apis/youtube/  
package
Zend_Gdata  
subpackage
YouTube  

Constants

Constant  AUTH_SERVICE_NAME = 'youtube'
Constant  CLIENTLOGIN_URL = 'https://www.google.com/youtube/accounts/ClientLogin'
Constant  STANDARD_TOP_RATED_URI = 'http://gdata.youtube.com/feeds/api/standardfeeds/top_rated'
Constant  STANDARD_MOST_VIEWED_URI = 'http://gdata.youtube.com/feeds/api/standardfeeds/most_viewed'
Constant  STANDARD_RECENTLY_FEATURED_URI = 'http://gdata.youtube.com/feeds/api/standardfeeds/recently_featured'
Constant  STANDARD_WATCH_ON_MOBILE_URI = 'http://gdata.youtube.com/feeds/api/standardfeeds/watch_on_mobile'
Constant  STANDARD_TOP_RATED_URI_V2 = 'http://gdata.youtube.com/feeds/api/standardfeeds/top_rated'
Constant  STANDARD_MOST_VIEWED_URI_V2 = 'http://gdata.youtube.com/feeds/api/standardfeeds/most_viewed'
Constant  STANDARD_RECENTLY_FEATURED_URI_V2 = 'http://gdata.youtube.com/feeds/api/standardfeeds/recently_featured'
Constant  STANDARD_WATCH_ON_MOBILE_URI_V2 = 'http://gdata.youtube.com/feeds/api/standardfeeds/watch_on_mobile'
Constant  USER_URI = 'http://gdata.youtube.com/feeds/api/users'
Constant  VIDEO_URI = 'http://gdata.youtube.com/feeds/api/videos'
Constant  PLAYLIST_REL = 'http://gdata.youtube.com/schemas/2007#playlist'
Constant  USER_UPLOADS_REL = 'http://gdata.youtube.com/schemas/2007#user.uploads'
Constant  USER_PLAYLISTS_REL = 'http://gdata.youtube.com/schemas/2007#user.playlists'
Constant  USER_SUBSCRIPTIONS_REL = 'http://gdata.youtube.com/schemas/2007#user.subscriptions'
Constant  USER_CONTACTS_REL = 'http://gdata.youtube.com/schemas/2007#user.contacts'
Constant  USER_FAVORITES_REL = 'http://gdata.youtube.com/schemas/2007#user.favorites'
Constant  VIDEO_RESPONSES_REL = 'http://gdata.youtube.com/schemas/2007#video.responses'
Constant  VIDEO_RATINGS_REL = 'http://gdata.youtube.com/schemas/2007#video.ratings'
Constant  VIDEO_COMPLAINTS_REL = 'http://gdata.youtube.com/schemas/2007#video.complaints'
Constant  ACTIVITY_FEED_URI = 'http://gdata.youtube.com/feeds/api/events'
Constant  FRIEND_ACTIVITY_FEED_URI = 'http://gdata.youtube.com/feeds/api/users/default/friendsactivity'
Constantstring  IN_REPLY_TO_SCHEME = 'http://gdata.youtube.com/schemas/2007#in-reply-to'

The URI of the in-reply-to schema for comments in reply to other comments.

string
Constantstring  INBOX_FEED_URI = 'http://gdata.youtube.com/feeds/api/users/default/inbox'

The URI of the inbox feed for the currently authenticated user.

string
Constantinteger  ACTIVITY_FEED_MAX_USERS = '20'

The maximum number of users for which activity can be requested for, as enforced by the API.

integer
Constantstring  FAVORITES_URI_SUFFIX = 'favorites'

The suffix for a feed of favorites.

string
Constantstring  UPLOADS_URI_SUFFIX = 'uploads'

The suffix for the user's upload feed.

string
Constantstring  RESPONSES_URI_SUFFIX = 'responses'

The suffix for a feed of video responses.

string
Constantstring  RELATED_URI_SUFFIX = 'related'

The suffix for a feed of related videos.

string
Constantstring  INBOX_URI_SUFFIX = 'inbox'

The suffix for a feed of messages (inbox entries).

string

Properties

Propertypublicarray  $namespaces= 'array'
static

Namespaces used for Zend_Gdata_YouTube

Default valuearrayDetails
Type
array

Methods

methodpublic__call( string $method, array $args ) : void

Provides a magic factory method to instantiate new objects with shorter syntax than would otherwise be required by the Zend Framework naming conventions. For instance, to construct a new Zend_Gdata_Calendar_Extension_Color, a developer simply needs to do $gCal->newColor(). For this magic constructor, packages are searched in the same order as which they appear in the $_registeredPackages array

Inherited from: \Zend_Gdata_App::__call()
Parameters
Name Type Description
$method string The method name being called
$args array The arguments passed to the call
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublic__construct( \Zend_Http_Client $client = null, string $applicationId = MyCompany-MyApp-1.0, string $clientId = null, string $developerKey = null ) : void

Create Zend_Gdata_YouTube object

Parameters
Name Type Description
$client \Zend_Http_Client

(optional) The HTTP client to use when when communicating with the Google servers.

$applicationId string

The identity of the app in the form of Company-AppName-Version

$clientId string The clientId issued by the YouTube dashboard
$developerKey string The developerKey issued by the YouTube dashboard
methodpublicdelete( mixed $data,  $remainingRedirects = null ) : void

DELETE entry with client object

Inherited from: \Zend_Gdata_App::delete()
Parameters
Name Type Description
$data mixed The Zend_Gdata_App_Entry or URL to delete
$remainingRedirects
Throws
Exception Description
\Zend_Gdata_App_Exception
\Zend_Gdata_App_HttpException
\Zend_Gdata_App_InvalidArgumentException
methodpublicget( string $uri, array $extraHeaders = array ) : \Zend_Http_Response

GET a URI using client object.

Inherited from: \Zend_Gdata_App::get()
Parameters
Name Type Description
$uri string GET URI
$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
\Zend_Http_Response
Throws
Exception Description
\Zend_Gdata_App_HttpException
methodpublicgetActivityForUser(  $username ) : \Zend_Gdata_YouTube_ActivityFeed

Retrieves the activity feed for users

Parameters
Name Type Description
$username
Returns
Type Description
\Zend_Gdata_YouTube_ActivityFeed
Throws
Exception Description
\Zend_Gdata_App_VersionException if using version less than 2.
methodpublicgetContactFeed( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_ContactFeed

Retrieves a feed of a user's contacts

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_ContactFeed The feed of contacts
methodpublicgetEntry( mixed $location,  $className = Zend_Gdata_Entry ) : string|\Zend_Gdata_App_Entry

Retrieve entry as string or object

Inherited from: \Zend_Gdata::getEntry()
Parameters
Name Type Description
$location mixed The location as string or Zend_Gdata_Query
$className
Returns
Type Description
string\Zend_Gdata_App_Entry Returns string only if the object mapping has been disabled explicitly by passing false to the useObjectMapping() function.
Throws
Exception Description
\Zend_Gdata_App_InvalidArgumentException
methodpublicgetFeed( mixed $location, string $className = Zend_Gdata_Feed ) : string|\Zend_Gdata_App_Feed

Retrieve feed as string or object

Inherited from: \Zend_Gdata::getFeed()
Parameters
Name Type Description
$location mixed The location as string or Zend_Gdata_Query
$className string The class type to use for returning the feed
Returns
Type Description
string\Zend_Gdata_App_Feed Returns string only if the object mapping has been disabled explicitly by passing false to the useObjectMapping() function.
Throws
Exception Description
\Zend_Gdata_App_InvalidArgumentException
methodpublicgetFormUploadToken( \Zend_Gdata_YouTube_VideoEntry $videoEntry, string $url = http://gdata.youtube.com/action/GetUploadToken ) : array

Retrieves a YouTube token

Parameters
Name Type Description
$videoEntry \Zend_Gdata_YouTube_VideoEntry The video entry
$url string The location as a string URL
Returns
Type Description
array An array containing a token and URL
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicgetFriendActivityForCurrentUser( ) : \Zend_Gdata_YouTube_ActivityFeed

Retrieve the activity of the currently authenticated users friend.

Returns
Type Description
\Zend_Gdata_YouTube_ActivityFeed
Throws
Exception Description
\Zend_Gdata_App_Exception if not logged in.
methodpublicgetFullVideoEntry(  $videoId ) : \Zend_Gdata_YouTube_VideoEntry|null

Retrieves a video entry from the user's upload feed.

Parameters
Name Type Description
$videoId
Returns
Type Description
\Zend_Gdata_YouTube_VideoEntrynull The video entry to be retrieved, or null if it was not found or the user requesting it did not have the appropriate permissions.
Throws
Exception Description
\Zend_Gdata_App_HttpException
methodpublicgetGzipEnabled( ) : boolean
static

Get the HTTP override state

Inherited from: \Zend_Gdata_App::getGzipEnabled()
Returns
Type Description
boolean
methodpublicgetHttpClient( ) : \Zend_Http_Client

Get the Zend_Http_Client object used for communication

Inherited from: \Zend_Gdata_App::getHttpClient()
Returns
Type Description
\Zend_Http_Client
methodpublicgetHttpMethodOverride( ) : boolean
static

Get the HTTP override state

Inherited from: \Zend_Gdata_App::getHttpMethodOverride()
Returns
Type Description
boolean
methodpublicgetInboxFeedForCurrentUser( ) : \Zend_Gdata_YouTube_InboxFeed|null

Retrieve a feed of messages in the currently authenticated user's inbox.

Returns
Type Description
\Zend_Gdata_YouTube_InboxFeednull
Throws
Exception Description
\Zend_Gdata_App_Exception if not logged in.
methodpublicgetMajorProtocolVersion( ) : int

Get the major protocol version that is in use.

Inherited from: \Zend_Gdata_App::getMajorProtocolVersion()
Returns
Type Description
int The major protocol version in use.
Details
see
\_majorProtocolVersion  
methodpublicgetMaxRedirects( ) : int
static

Get the maximum number of redirects to follow during HTTP operations

Inherited from: \Zend_Gdata_App::getMaxRedirects()
Returns
Type Description
int Maximum number of redirects to follow
methodpublicgetMinorProtocolVersion( ) : \(int|\NULL)

Get the minor protocol version that is in use.

Inherited from: \Zend_Gdata_App::getMinorProtocolVersion()
Returns
Type Description
\(int\NULL) The major protocol version in use, or NULL if no minor version is specified.
Details
see
\_minorProtocolVersion  
methodpublicgetMostViewedVideoFeed( mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of the most viewed videos.

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicgetPlaylistListFeed( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_PlaylistListFeed

Retrieves a feed which lists a user's playlist

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_PlaylistListFeed The feed of playlists
methodpublicgetPlaylistVideoFeed( mixed $location ) : \Zend_Gdata_YouTube_PlaylistVideoFeed

Retrieves a feed of videos in a particular playlist

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_PlaylistVideoFeed The feed of videos found at the specified URL.
methodpublicgetRecentlyFeaturedVideoFeed( mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of recently featured videos.

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicgetRelatedVideoFeed( string $videoId = null, mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of videos related to the specified video ID.

Parameters
Name Type Description
$videoId string The videoId of interest
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicgetStaticHttpClient( ) : \Zend_Http_Client
static

Gets the HTTP client object. If none is set, a new Zend_Http_Client will be used.

Inherited from: \Zend_Gdata_App::getStaticHttpClient()
Returns
Type Description
\Zend_Http_Client
methodpublicgetSubscriptionFeed( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_SubscriptionListFeed

Retrieves a feed of a user's subscriptions

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_SubscriptionListFeed The feed of subscriptions
methodpublicgetTopRatedVideoFeed( mixed $location = null ) : \Zend_Gdata_YouTube_CommentFeed

Retrieves a feed of comments related to the specified video ID.

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_CommentFeed The feed of videos found at the specified URL.
methodpublicgetUserFavorites( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a user's favorites

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The videos favorited by the user
methodpublicgetUserProfile( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_UserProfileEntry

Retrieves a user's profile as an entry

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_UserProfileEntry The user profile entry
methodpublicgetUserUploads( string $user = null, mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a user's uploads

Parameters
Name Type Description
$user string

(optional) The username of interest

$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The videos uploaded by the user
methodpublicgetVerboseExceptionMessages( ) : boolean
static

Get whether to use verbose exception messages

Inherited from: \Zend_Gdata_App::getVerboseExceptionMessages()

In the case of HTTP errors, use the body of the HTTP response in the exception message.

Returns
Type Description
boolean
methodpublicgetVideoCommentFeed( string $videoId = null, mixed $location = null ) : \Zend_Gdata_YouTube_CommentFeed

Retrieves a feed of comments related to the specified video ID.

Parameters
Name Type Description
$videoId string The videoId of interest
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_CommentFeed The feed of videos found at the specified URL.
methodpublicgetVideoEntry( mixed $videoId = null, mixed $location = null, boolean $fullEntry = false ) : \Zend_Gdata_YouTube_VideoEntry

Retrieves a specific video entry.

Parameters
Name Type Description
$videoId mixed The ID of the video to retrieve.
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined.

$fullEntry boolean

(optional) Retrieve the full metadata for the entry. Only possible if entry belongs to currently authenticated user. An exception will be thrown otherwise.

Returns
Type Description
\Zend_Gdata_YouTube_VideoEntry The video entry found at the specified URL.
Throws
Exception Description
\Zend_Gdata_App_HttpException
methodpublicgetVideoFeed( mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of videos.

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicgetVideoResponseFeed( string $videoId = null, mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of video responses related to the specified video ID.

Parameters
Name Type Description
$videoId string The videoId of interest
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicgetWatchOnMobileVideoFeed( mixed $location = null ) : \Zend_Gdata_YouTube_VideoFeed

Retrieves a feed of videos recently featured for mobile devices.

These videos will have RTSP links in the $entry->mediaGroup->content

Parameters
Name Type Description
$location mixed

(optional) The URL to query or a Zend_Gdata_Query object from which a URL can be determined

Returns
Type Description
\Zend_Gdata_YouTube_VideoFeed The feed of videos found at the specified URL.
methodpublicimport( string $uri, \Zend_Http_Client $client = null, string $className = Zend_Gdata_Feed ) : string|\Zend_Gdata_App_Feed
static

Imports a feed located at $uri.

Inherited from: \Zend_Gdata::import()
Parameters
Name Type Description
$uri string
$client \Zend_Http_Client The client used for communication
$className string The class which is used as the return type
Returns
Type Description
string\Zend_Gdata_App_Feed Returns string only if the object mapping has been disabled explicitly by passing false to the useObjectMapping() function.
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicimportFile( string $filename, string $className = Zend_Gdata_App_Feed, string $useIncludePath = false ) : \Zend_Gdata_App_Feed
static

Imports a feed from a file located at $filename.

Inherited from: \Zend_Gdata_App::importFile()
Parameters
Name Type Description
$filename string
$className string The class which is used as the return type
$useIncludePath string Whether the include_path should be searched
Returns
Type Description
\Zend_Gdata_App_Feed
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicimportString( string $string, string $className = Zend_Gdata_App_Feed,  $majorProtocolVersion = null,  $minorProtocolVersion = null ) : \Zend_Gdata_App_Feed
static

Imports a feed represented by $string.

Inherited from: \Zend_Gdata_App::importString()
Parameters
Name Type Description
$string string
$className string The class which is used as the return type
$majorProtocolVersion
$minorProtocolVersion
Returns
Type Description
\Zend_Gdata_App_Feed
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicimportUrl( string $url, string $className = Zend_Gdata_App_Feed, array $extraHeaders = array ) : string|\Zend_Gdata_App_Feed

Imports the specified URL (non-statically).

Inherited from: \Zend_Gdata_App::importUrl()
Parameters
Name Type Description
$url string The URL to import
$className string The class which is used as the return type
$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
string\Zend_Gdata_App_Feed Returns string only if the object mapping has been disabled explicitly by passing false to the useObjectMapping() function.
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicinsertEntry( mixed $data, string $uri, string $className = Zend_Gdata_App_Entry, array $extraHeaders = array ) : \Zend_Gdata_App_Entry

Inserts an entry to a given URI and returns the response as a fully formed Entry.

Inherited from: \Zend_Gdata_App::insertEntry()
Parameters
Name Type Description
$data mixed The Zend_Gdata_App_Entry or XML to post
$uri string POST URI
$className string The class of entry to be returned.
$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
\Zend_Gdata_App_Entry The entry returned by the service after insertion.
methodpublicisAuthenticated( ) : boolean

Determines whether service object is authenticated.

Inherited from: \Zend_Gdata::isAuthenticated()
Returns
Type Description
boolean True if service object is authenticated, false otherwise.
methodpublicparseFormUploadTokenResponse( string $response ) : array
static

Helper function for parsing a YouTube token response

Parameters
Name Type Description
$response string The service response
Returns
Type Description
array An array containing the token and URL
Throws
Exception Description
\Zend_Gdata_App_Exception
methodpublicperformHttpRequest( string $method, string $url, array $headers = array, string $body = null, string $contentType = null, int $remainingRedirects = null ) : \Zend_Http_Response

Performs a HTTP request using the specified method.

Inherited from: \Zend_Gdata::performHttpRequest()

Overrides the definition in the parent (Zend_Gdata_App) and uses the Zend_Gdata_HttpClient functionality to filter the HTTP requests and responses.

Parameters
Name Type Description
$method string

The HTTP method for the request - 'GET', 'POST', 'PUT', 'DELETE'

$url string

The URL to which this request is being performed, or null if found in $data

$headers array An associative array of HTTP headers for this request
$body string The body of the HTTP request
$contentType string The value for the content type of the request body
$remainingRedirects int Number of redirects to follow if requests results in one
Returns
Type Description
\Zend_Http_Response The response object
methodpublicpost( mixed $data, string $uri = null,  $remainingRedirects = null, string $contentType = null, array $extraHeaders = null ) : \Zend_Http_Response

POST data with client object

Inherited from: \Zend_Gdata_App::post()
Parameters
Name Type Description
$data mixed The Zend_Gdata_App_Entry or XML to post
$uri string POST URI
$remainingRedirects
$contentType string

Content-type of the data

$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
\Zend_Http_Response
Throws
Exception Description
\Zend_Gdata_App_Exception
\Zend_Gdata_App_HttpException
\Zend_Gdata_App_InvalidArgumentException
methodpublicprepareRequest( string $method, string $url = null, array $headers = array, mixed $data = null, string $contentTypeOverride = null ) : array

Provides pre-processing for HTTP requests to APP services.

Inherited from: \Zend_Gdata_App::prepareRequest()
  1. Checks the $data element and, if it's an entry, extracts the XML, multipart data, edit link (PUT,DELETE), etc.
  2. If $data is a string, sets the default content-type header as 'application/atom+xml' if it's not already been set.
  3. Adds a x-http-method override header and changes the HTTP method to 'POST' if necessary as per getHttpMethodOverride()
Parameters
Name Type Description
$method string

The HTTP method for the request - 'GET', 'POST', 'PUT', 'DELETE'

$url string

The URL to which this request is being performed, or null if found in $data

$headers array An associative array of HTTP headers for this request
$data mixed The Zend_Gdata_App_Entry or XML for the body of the request
$contentTypeOverride string The override value for the content type of the request body
Returns
Type Description
array An associative array containing the determined 'method', 'url', 'data', 'headers', 'contentType'
methodpublicput( mixed $data, string $uri = null,  $remainingRedirects = null, string $contentType = null, array $extraHeaders = null ) : \Zend_Http_Response

PUT data with client object

Inherited from: \Zend_Gdata_App::put()
Parameters
Name Type Description
$data mixed The Zend_Gdata_App_Entry or XML to post
$uri string PUT URI
$remainingRedirects
$contentType string

Content-type of the data

$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
\Zend_Http_Response
Throws
Exception Description
\Zend_Gdata_App_Exception
\Zend_Gdata_App_HttpException
\Zend_Gdata_App_InvalidArgumentException
methodpublicregisterPackage( string $name ) : void

Adds a Zend Framework package to the $_registeredPackages array.

Inherited from: \Zend_Gdata_App::registerPackage()

This array is searched when using the magic __call method below to instantiante new objects.

Parameters
Name Type Description
$name string

The name of the package (eg Zend_Gdata_App)

methodpublicreplyToCommentEntry( \Zend_Gdata_YouTube_CommentEntry $commentEntry, string $commentText ) : \Zend_Gdata_YouTube_CommentEntry

Post a comment in reply to an existing comment

Parameters
Name Type Description
$commentEntry \Zend_Gdata_YouTube_CommentEntry The comment entry to reply to
$commentText string The text of the comment to post
Returns
Type Description
\Zend_Gdata_YouTube_CommentEntry the posted comment
methodpublicsendVideoMessage( string $body, \Zend_Gdata_YouTube_VideoEntry $videoEntry = null, string $videoId = null, string $recipientUserName ) : \Zend_Gdata_YouTube_InboxEntry|null

Send a video message.

Note: Either a Zend_Gdata_YouTube_VideoEntry or a valid video ID must be provided.

Parameters
Name Type Description
$body string The body of the message
$videoEntry \Zend_Gdata_YouTube_VideoEntry

(optional) The video entry to send

$videoId string The id of the video to send
$recipientUserName string The username of the recipient
Returns
Type Description
\Zend_Gdata_YouTube_InboxEntrynull The Zend_Gdata_YouTube_Inbox_Entry representing the sent message.
Throws
Exception Description
\Zend_Gdata_App_InvalidArgumentException if no valid Zend_Gdata_YouTube_VideoEntry or videoId were provided
methodpublicsetGzipEnabled( boolean $enabled = false ) : void
static

Toggle requesting gzip encoded responses

Inherited from: \Zend_Gdata_App::setGzipEnabled()
Parameters
Name Type Description
$enabled boolean Whether or not to enable gzipped responses
methodpublicsetHttpClient( \Zend_Http_Client $client,  $applicationId = MyCompany-MyApp-1.0,  $clientId = null,  $developerKey = null ) : \Zend_Gdata_App

Set the Zend_Http_Client object used for communication

Parameters
Name Type Description
$client \Zend_Http_Client The client to use for communication
$applicationId
$clientId
$developerKey
Returns
Type Description
\Zend_Gdata_App Provides a fluent interface
Throws
Exception Description
\Zend_Gdata_App_HttpException
methodpublicsetHttpMethodOverride( boolean $override = true ) : void
static

Toggle using POST instead of PUT and DELETE HTTP methods

Inherited from: \Zend_Gdata_App::setHttpMethodOverride()

Some feed implementations do not accept PUT and DELETE HTTP methods, or they can't be used because of proxies or other measures. This allows turning on using POST where PUT and DELETE would normally be used; in addition, an X-Method-Override header will be sent with a value of PUT or DELETE as appropriate.

Parameters
Name Type Description
$override boolean Whether to override PUT and DELETE with POST.
methodpublicsetMajorProtocolVersion( int $value ) : void

Set the major protocol version that should be used. Values < 1 will cause a Zend_Gdata_App_InvalidArgumentException to be thrown.

Inherited from: \Zend_Gdata_App::setMajorProtocolVersion()
Parameters
Name Type Description
$value int The major protocol version to use.
Throws
Exception Description
\Zend_Gdata_App_InvalidArgumentException
Details
see
\_majorProtocolVersion  
methodpublicsetMaxRedirects( int $maxRedirects ) : void
static

Set the maximum number of redirects to follow during HTTP operations

Inherited from: \Zend_Gdata_App::setMaxRedirects()
Parameters
Name Type Description
$maxRedirects int Maximum number of redirects to follow
methodpublicsetMinorProtocolVersion( \(int|\NULL) $value ) : void

Set the minor protocol version that should be used. If set to NULL, no minor protocol version will be sent to the server. Values < 0 will cause a Zend_Gdata_App_InvalidArgumentException to be thrown.

Inherited from: \Zend_Gdata_App::setMinorProtocolVersion()
Parameters
Name Type Description
$value \(int|\NULL) The minor protocol version to use.
Throws
Exception Description
\Zend_Gdata_App_InvalidArgumentException
Details
see
\_minorProtocolVersion  
methodpublicsetStaticHttpClient( \Zend_Http_Client $httpClient ) : void
static

Set the static HTTP client instance

Inherited from: \Zend_Gdata_App::setStaticHttpClient()

Sets the static HTTP client object to use for retrieving the feed.

Parameters
Name Type Description
$httpClient \Zend_Http_Client
methodpublicsetVerboseExceptionMessages( boolean $verbose ) : void
static

Set whether to use verbose exception messages

Inherited from: \Zend_Gdata_App::setVerboseExceptionMessages()

In the case of HTTP errors, use the body of the HTTP response in the exception message.

Parameters
Name Type Description
$verbose boolean Whether to use verbose exception messages
methodpublicupdateEntry( mixed $data, string|null $uri = null, string|null $className = null, array $extraHeaders = array ) : \Zend_Gdata_App_Entry

Update an entry

Inherited from: \Zend_Gdata_App::updateEntry()
Parameters
Name Type Description
$data mixed

Zend_Gdata_App_Entry or XML (w/ID and link rel='edit')

$uri string|null

The URI to send requests to, or null if $data contains the URI.

$className string|null

The name of the class that should be deserialized from the server response. If null, then 'Zend_Gdata_App_Entry' will be used.

$extraHeaders array

Extra headers to add to the request, as an array of string-based key/value pairs.

Returns
Type Description
\Zend_Gdata_App_Entry The entry returned from the server
Throws
Exception Description
\Zend_Gdata_App_Exception
Documentation was generated by DocBlox 0.13.3.