gdata_youtube_service_new ()

GDataYouTubeService *
gdata_youtube_service_new (const gchar *developer_key,
                           GDataAuthorizer *authorizer);

Creates a new GDataYouTubeService using the given GDataAuthorizer. If authorizer is NULL, all requests are made as an unauthenticated user. The developer_key must be unique for your application, and as

Since: 0.9.0

gdata_youtube_service_get_primary_authorization_domain ()

GDataAuthorizationDomain *
gdata_youtube_service_get_primary_authorization_domain
                               (void);

The primary GDataAuthorizationDomain for interacting with YouTube. This will not normally need to be used, as it's used internally by the GDataYouTubeService methods. However, if using the plain GDataService methods to implement custom queries or requests which libgdata does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.

Since: 0.9.0

gdata_youtube_service_query_videos ()

GDataFeed *
gdata_youtube_service_query_videos (GDataYouTubeService *self,
                                    GDataQuery *query,
                                    GCancellable *cancellable,
                                    GDataQueryProgressCallback progress_callback,
                                    gpointer progress_user_data,
                                    GError **error);

Queries the service for videos matching the parameters set on the GDataQuery. This searches site-wide, and imposes no other restrictions or parameters on the query.

Parameters and errors are as for gdata_service_query().

gdata_youtube_service_query_videos_async ()

void
gdata_youtube_service_query_videos_async
                               (GDataYouTubeService *self,
                                GDataQuery *query,
                                GCancellable *cancellable,
                                GDataQueryProgressCallback progress_callback,
                                gpointer progress_user_data,
                                GDestroyNotify destroy_progress_user_data,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Queries the service for videos matching the parameters set on the GDataQuery. This searches site-wide, and imposes no other restrictions or parameters on the query. self and query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_videos(), which is the synchronous version of this function.

When the operation is finished, callback will be called. You can then call gdata_service_query_finish() to get the results of the operation.

Since: 0.9.1

gdata_youtube_service_query_related ()

GDataFeed *
gdata_youtube_service_query_related (GDataYouTubeService *self,
                                     GDataYouTubeVideo *video,
                                     GDataQuery *query,
                                     GCancellable *cancellable,
                                     GDataQueryProgressCallback progress_callback,
                                     gpointer progress_user_data,
                                     GError **error);

Queries the service for videos related to video . The algorithm determining which videos are related is on the server side.

Parameters and other errors are as for gdata_service_query().

gdata_youtube_service_query_related_async ()

void
gdata_youtube_service_query_related_async
                               (GDataYouTubeService *self,
                                GDataYouTubeVideo *video,
                                GDataQuery *query,
                                GCancellable *cancellable,
                                GDataQueryProgressCallback progress_callback,
                                gpointer progress_user_data,
                                GDestroyNotify destroy_progress_user_data,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Queries the service for videos related to video . The algorithm determining which videos are related is on the server side. self and query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_related(), which is the synchronous version of this function.

When the operation is finished, callback will be called. You can then call gdata_service_query_finish() to get the results of the operation.

Since: 0.9.1

gdata_youtube_service_query_standard_feed ()

GDataFeed *
gdata_youtube_service_query_standard_feed
                               (GDataYouTubeService *self,
                                GDataYouTubeStandardFeedType feed_type,
                                GDataQuery *query,
                                GCancellable *cancellable,
                                GDataQueryProgressCallback progress_callback,
                                gpointer progress_user_data,
                                GError **error);

Queries the service's standard feed_type feed to build a GDataFeed.

Note that with the port from v2 to v3 of the YouTube API in libgdata 0.17.0, all feed types except GDATA_YOUTUBE_MOST_POPULAR_FEED have been deprecated. Other feed types will now transparently return GDATA_YOUTUBE_MOST_POPULAR_FEED, limited to the past 24 hours.

Parameters and errors are as for gdata_service_query().

gdata_youtube_service_query_standard_feed_async ()

void
gdata_youtube_service_query_standard_feed_async
                               (GDataYouTubeService *self,
                                GDataYouTubeStandardFeedType feed_type,
                                GDataQuery *query,
                                GCancellable *cancellable,
                                GDataQueryProgressCallback progress_callback,
                                gpointer progress_user_data,
                                GDestroyNotify destroy_progress_user_data,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Queries the service's standard feed_type feed to build a GDataFeed. self and query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_standard_feed(), which is the synchronous version of this function.

When the operation is finished, callback will be called. You can then call gdata_service_query_finish() to get the results of the operation.

Since: 0.9.1

gdata_youtube_service_upload_video ()

GDataUploadStream *
gdata_youtube_service_upload_video (GDataYouTubeService *self,
                                    GDataYouTubeVideo *video,
                                    const gchar *slug,
                                    const gchar *content_type,
                                    GCancellable *cancellable,
                                    GError **error);

Uploads a video to YouTube, using the properties from video and the file data written to the resulting GDataUploadStream.

If video has already been inserted, a GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. If no user is authenticated with the service, GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned.

The stream returned by this function should be written to using the standard GOutputStream methods, asychronously or synchronously. Once the stream is closed (using g_output_stream_close()), gdata_youtube_service_finish_video_upload() should be called on it to parse and return the updated GDataYouTubeVideo for the uploaded video. This must be done, as video isn't updated in-place.

In order to cancel the upload, a GCancellable passed in to cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual GOutputStream operations on the GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the “cancellable” for more details.

Any upload errors will be thrown by the stream methods, and may come from the GDataServiceError domain.

Since: 0.8.0

gdata_youtube_service_finish_video_upload ()

GDataYouTubeVideo *
gdata_youtube_service_finish_video_upload
                               (GDataYouTubeService *self,
                                GDataUploadStream *upload_stream,
                                GError **error);

Finish off a video upload operation started by gdata_youtube_service_upload_video(), parsing the result and returning the new GDataYouTubeVideo.

If an error occurred during the upload operation, it will have been returned during the operation (e.g. by g_output_stream_splice() or one of the other stream methods). In such a case, NULL will be returned but error will remain unset. error is only set in the case that the server indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.

Since: 0.8.0

gdata_youtube_service_get_categories ()

GDataAPPCategories *
gdata_youtube_service_get_categories (GDataYouTubeService *self,
                                      GCancellable *cancellable,
                                      GError **error);

Gets a list of the categories currently in use on YouTube. The returned GDataAPPCategories contains a list of GDataYouTubeCategorys which enumerate the current YouTube categories.

The category labels (“label”) are localised based on the value of “locale”.

Since: 0.7.0

gdata_youtube_service_get_categories_async ()

void
gdata_youtube_service_get_categories_async
                               (GDataYouTubeService *self,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Gets a list of the categories currently in use on YouTube. self is reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_youtube_service_get_categories(), which is the synchronous version of this function.

When the operation is finished, callback will be called. You can then call gdata_youtube_service_get_categories_finish() to get the results of the operation.

Since: 0.7.0

gdata_youtube_service_get_categories_finish ()

GDataAPPCategories *
gdata_youtube_service_get_categories_finish
                               (GDataYouTubeService *self,
                                GAsyncResult *async_result,
                                GError **error);

Finishes an asynchronous request for a list of categories on YouTube, as started with gdata_youtube_service_get_categories_async().

Since: 0.7.0

gdata_youtube_service_get_developer_key ()

const gchar *
gdata_youtube_service_get_developer_key
                               (GDataYouTubeService *self);

Gets the “developer-key” property from the GDataYouTubeService.

GDataYouTubeService

typedef struct _GDataYouTubeService GDataYouTubeService;

All the fields in the GDataYouTubeService structure are private and should never be accessed directly.

GDataYouTubeServiceClass

typedef struct {
} GDataYouTubeServiceClass;

All the fields in the GDataYouTubeServiceClass structure are private and should never be accessed directly.

enum GDataYouTubeServiceError

Error codes for GDataYouTubeService operations.

enum GDataYouTubeStandardFeedType

Standard feed types for standard feed queries with gdata_youtube_service_query_standard_feed(). For more information, see the

The “developer-key” property

  “developer-key”            gchar *

The developer key your application has registered with the YouTube API. For more information, see the online documentation.

With the port from v2 to v3 of the YouTube API in libgdata 0.17.0, it might be necessary to update your application’s developer key.

Flags: Read / Write / Construct Only

Default value: NULL