Blame docs/reference/html/GDataYouTubeService.html

Packit 4b6dd7
Packit 4b6dd7
<html>
Packit 4b6dd7
<head>
Packit 4b6dd7
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit 4b6dd7
<title>GDataYouTubeService: GData Reference Manual</title>
Packit 4b6dd7
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit 4b6dd7
<link rel="home" href="index.html" title="GData Reference Manual">
Packit 4b6dd7
<link rel="up" href="ch13.html" title="YouTube API">
Packit 4b6dd7
<link rel="prev" href="ch13.html" title="YouTube API">
Packit 4b6dd7
<link rel="next" href="GDataYouTubeFeed.html" title="GDataYouTubeFeed">
Packit 4b6dd7
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit 4b6dd7
<link rel="stylesheet" href="style.css" type="text/css">
Packit 4b6dd7
</head>
Packit 4b6dd7
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Top  | 
Packit 4b6dd7
                  Description  | 
Packit 4b6dd7
                  Object Hierarchy  | 
Packit 4b6dd7
                  Implemented Interfaces  | 
Packit 4b6dd7
                  Properties
Packit 4b6dd7
Packit 4b6dd7
Home
Packit 4b6dd7
Up
Packit 4b6dd7
Prev
Packit 4b6dd7
Next
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDataYouTubeService

Packit 4b6dd7

GDataYouTubeService — GData YouTube service object

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Stability Level

Packit 4b6dd7
Packit 4b6dd7
develop applications to these interfaces, release them, and have confidence that
Packit 4b6dd7
they will run on all minor releases of the product (after the one in which the
Packit 4b6dd7
interface was introduced, and within the same major release). Even at a major
Packit 4b6dd7
release, incompatible changes are expected to be rare, and to have strong
Packit 4b6dd7
justifications.
Packit 4b6dd7
">Stable, unless otherwise indicated
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataYouTubeService *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_new ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataAuthorizationDomain *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_get_primary_authorization_domain ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataFeed *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_videos ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_videos_async ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataFeed *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_related ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_related_async ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataFeed *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_standard_feed ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_query_standard_feed_async ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataUploadStream *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_upload_video ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataYouTubeVideo *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_finish_video_upload ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataAPPCategories *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_get_categories ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_get_categories_async ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataAPPCategories *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_get_categories_finish ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
const gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_youtube_service_get_developer_key ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Properties

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
developer-key
Packit 4b6dd7
Read / Write / Construct Only
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataYouTubeService
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataYouTubeServiceClass
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
enum
Packit 4b6dd7
GDataYouTubeServiceError
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
enum
Packit 4b6dd7
GDataYouTubeStandardFeedType
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Object Hierarchy

Packit 4b6dd7
    GObject
Packit 4b6dd7
    ╰── GDataService
Packit 4b6dd7
        ╰── GDataYouTubeService
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Implemented Interfaces

Packit 4b6dd7

Packit 4b6dd7
GDataYouTubeService implements
Packit 4b6dd7
 GDataBatchable.

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Includes

Packit 4b6dd7
#include <gdata/services/youtube/gdata-youtube-service.h>
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Description

Packit 4b6dd7

GDataYouTubeService is a subclass of GDataService for communicating with the GData API of YouTube. It supports querying for and

Packit 4b6dd7
uploading videos using version 3 of the API.

Packit 4b6dd7

The YouTube API supports returning different sets of properties for

Packit 4b6dd7
GDataYouTubeVideos depending on the specific query. For search results, only
Packit 4b6dd7
‘snippet’ properties are returned (including “title”,
Packit 4b6dd7
“summary” and the set of thumbnails). For querying single videos,
Packit 4b6dd7
a more complete set of properties are returned — so use
Packit 4b6dd7
gdata_service_query_single_entry_async() to get further details on a video.

Packit 4b6dd7

For more details of YouTube's GData API, see the

Packit 4b6dd7
online documentation.

Packit 4b6dd7
Packit 4b6dd7

Example 11. Getting a Localized List of YouTube Categories

Packit 4b6dd7
Packit 4b6dd7
  
Packit 4b6dd7
    
Packit 4b6dd7
      
Packit 4b6dd7
        
1
Packit 4b6dd7
2
Packit 4b6dd7
3
Packit 4b6dd7
4
Packit 4b6dd7
5
Packit 4b6dd7
6
Packit 4b6dd7
7
Packit 4b6dd7
8
Packit 4b6dd7
9
Packit 4b6dd7
10
Packit 4b6dd7
11
Packit 4b6dd7
12
Packit 4b6dd7
13
Packit 4b6dd7
14
Packit 4b6dd7
15
Packit 4b6dd7
16
Packit 4b6dd7
17
Packit 4b6dd7
18
Packit 4b6dd7
19
Packit 4b6dd7
20
Packit 4b6dd7
21
Packit 4b6dd7
22
Packit 4b6dd7
23
Packit 4b6dd7
24
Packit 4b6dd7
        
GDataYouTubeService *service;
Packit 4b6dd7
GDataAPPCategories *app_categories;
Packit 4b6dd7
GList *categories, *i;
Packit 4b6dd7
Packit 4b6dd7
/* Create a service and set its locale to Italian, which localizes the categories to Italian */
Packit 4b6dd7
service = create_youtube_service ();
Packit 4b6dd7
gdata_service_set_locale (GDATA_SERVICE (service), "it");
Packit 4b6dd7
Packit 4b6dd7
/* Query the server for the current list of YouTube categories (in Italian) */
Packit 4b6dd7
app_categories = gdata_youtube_service_get_categories (service, NULL, NULL);
Packit 4b6dd7
categories = gdata_app_categories_get_categories (app_categories);
Packit 4b6dd7
Packit 4b6dd7
/* Iterate through the categories */
Packit 4b6dd7
for (i = categories; i != NULL; i = i->next) {
Packit 4b6dd7
    GDataYouTubeCategory *category = GDATA_YOUTUBE_CATEGORY (i->data);
Packit 4b6dd7
Packit 4b6dd7
    if (gdata_youtube_category_is_deprecated (category) == FALSE && gdata_youtube_category_is_browsable (category, "IT") == TRUE) {
Packit 4b6dd7
        /* Do something with the category here, as it's not deprecated, and is browsable in the given region */
Packit 4b6dd7
        add_to_ui (gdata_category_get_term (GDATA_CATEGORY (category)), gdata_category_get_label (GDATA_CATEGORY (category)));
Packit 4b6dd7
    }
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (app_categories);
Packit 4b6dd7
g_object_unref (service);
Packit 4b6dd7
      
Packit 4b6dd7
    
Packit 4b6dd7
  
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7

Example 12. Uploading a Video from Disk

Packit 4b6dd7
Packit 4b6dd7
  
Packit 4b6dd7
    
Packit 4b6dd7
      
Packit 4b6dd7
        
1
Packit 4b6dd7
2
Packit 4b6dd7
3
Packit 4b6dd7
4
Packit 4b6dd7
5
Packit 4b6dd7
6
Packit 4b6dd7
7
Packit 4b6dd7
8
Packit 4b6dd7
9
Packit 4b6dd7
10
Packit 4b6dd7
11
Packit 4b6dd7
12
Packit 4b6dd7
13
Packit 4b6dd7
14
Packit 4b6dd7
15
Packit 4b6dd7
16
Packit 4b6dd7
17
Packit 4b6dd7
18
Packit 4b6dd7
19
Packit 4b6dd7
20
Packit 4b6dd7
21
Packit 4b6dd7
22
Packit 4b6dd7
23
Packit 4b6dd7
24
Packit 4b6dd7
25
Packit 4b6dd7
26
Packit 4b6dd7
27
Packit 4b6dd7
28
Packit 4b6dd7
29
Packit 4b6dd7
30
Packit 4b6dd7
31
Packit 4b6dd7
32
Packit 4b6dd7
33
Packit 4b6dd7
34
Packit 4b6dd7
35
Packit 4b6dd7
36
Packit 4b6dd7
37
Packit 4b6dd7
38
Packit 4b6dd7
39
Packit 4b6dd7
40
Packit 4b6dd7
41
Packit 4b6dd7
42
Packit 4b6dd7
43
Packit 4b6dd7
44
Packit 4b6dd7
45
Packit 4b6dd7
46
Packit 4b6dd7
47
Packit 4b6dd7
48
Packit 4b6dd7
49
Packit 4b6dd7
50
Packit 4b6dd7
51
Packit 4b6dd7
52
Packit 4b6dd7
53
Packit 4b6dd7
54
Packit 4b6dd7
55
Packit 4b6dd7
56
Packit 4b6dd7
57
Packit 4b6dd7
58
Packit 4b6dd7
59
Packit 4b6dd7
60
Packit 4b6dd7
61
Packit 4b6dd7
62
Packit 4b6dd7
63
Packit 4b6dd7
64
Packit 4b6dd7
65
Packit 4b6dd7
66
Packit 4b6dd7
67
Packit 4b6dd7
68
Packit 4b6dd7
69
Packit 4b6dd7
70
Packit 4b6dd7
71
Packit 4b6dd7
72
Packit 4b6dd7
73
Packit 4b6dd7
74
Packit 4b6dd7
75
Packit 4b6dd7
76
Packit 4b6dd7
77
Packit 4b6dd7
78
Packit 4b6dd7
79
Packit 4b6dd7
80
Packit 4b6dd7
81
Packit 4b6dd7
82
Packit 4b6dd7
83
Packit 4b6dd7
84
Packit 4b6dd7
85
Packit 4b6dd7
86
Packit 4b6dd7
87
Packit 4b6dd7
88
Packit 4b6dd7
89
Packit 4b6dd7
90
Packit 4b6dd7
91
Packit 4b6dd7
92
Packit 4b6dd7
93
Packit 4b6dd7
94
Packit 4b6dd7
95
Packit 4b6dd7
96
Packit 4b6dd7
97
Packit 4b6dd7
98
Packit 4b6dd7
99
Packit 4b6dd7
        
GDataYouTubeService *service;
Packit 4b6dd7
GDataYouTubeVideo *video, *uploaded_video;
Packit 4b6dd7
GDataMediaCategory *category;
Packit 4b6dd7
const gchar * const tags[] = { "tag1", "tag2", NULL };
Packit 4b6dd7
GFile *video_file;
Packit 4b6dd7
GFileInfo *file_info;
Packit 4b6dd7
const gchar *slug, *content_type;
Packit 4b6dd7
GFileInputStream *file_stream;
Packit 4b6dd7
GDataUploadStream *upload_stream;
Packit 4b6dd7
GError *error = NULL;
Packit 4b6dd7
Packit 4b6dd7
/* Create a service */
Packit 4b6dd7
service = create_youtube_service ();
Packit 4b6dd7
Packit 4b6dd7
/* Get the video file to upload */
Packit 4b6dd7
video_file = g_file_new_for_path ("sample.ogg");
Packit 4b6dd7
Packit 4b6dd7
/* Get the file's display name and content type */
Packit 4b6dd7
file_info = g_file_query_info (video_file, G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "," G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE,
Packit 4b6dd7
                               G_FILE_QUERY_INFO_NONE, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error getting video file information: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    g_object_unref (video_file);
Packit 4b6dd7
    g_object_unref (service);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
slug = g_file_info_get_display_name (file_info);
Packit 4b6dd7
content_type = g_file_info_get_content_type (file_info);
Packit 4b6dd7
Packit 4b6dd7
/* Get an input stream for the file */
Packit 4b6dd7
file_stream = g_file_read (video_file, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (video_file);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error getting video file stream: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    g_object_unref (file_info);
Packit 4b6dd7
    g_object_unref (service);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Create the video to upload */
Packit 4b6dd7
video = gdata_youtube_video_new (NULL);
Packit 4b6dd7
Packit 4b6dd7
gdata_entry_set_title (GDATA_ENTRY (video), "Video Title");
Packit 4b6dd7
gdata_youtube_video_set_description (video, "Video description.");
Packit 4b6dd7
gdata_youtube_video_set_keywords (video, video_tags);
Packit 4b6dd7
Packit 4b6dd7
category = gdata_media_category_new ("People", "http://gdata.youtube.com/schemas/2007/categories.cat", NULL);
Packit 4b6dd7
gdata_youtube_video_set_category (video, category);
Packit 4b6dd7
g_object_unref (category);
Packit 4b6dd7
Packit 4b6dd7
/* Get an upload stream for the video */
Packit 4b6dd7
upload_stream = gdata_youtube_service_upload_video (service, video, slug, content_type, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (video);
Packit 4b6dd7
g_object_unref (file_info);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error getting upload stream: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    g_object_unref (file_stream);
Packit 4b6dd7
    g_object_unref (service);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Upload the video. This is a blocking operation, and should normally be done asynchronously. */
Packit 4b6dd7
g_output_stream_splice (G_OUTPUT_STREAM (upload_stream), G_INPUT_STREAM (file_stream),
Packit 4b6dd7
                        G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE | G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (file_stream);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error splicing streams: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    g_object_unref (upload_stream);
Packit 4b6dd7
    g_object_unref (service);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Finish off the upload by parsing the returned updated video entry */
Packit 4b6dd7
uploaded_video = gdata_youtube_service_finish_video_upload (service, upload_stream, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (upload_stream);
Packit 4b6dd7
g_object_unref (service);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error uploading video: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Do something with the uploaded video */
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (uploaded_video);
Packit 4b6dd7
      
Packit 4b6dd7
    
Packit 4b6dd7
  
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7

Example 13. Querying for Videos from a Standard Feed

Packit 4b6dd7
Packit 4b6dd7
  
Packit 4b6dd7
    
Packit 4b6dd7
      
Packit 4b6dd7
        
1
Packit 4b6dd7
2
Packit 4b6dd7
3
Packit 4b6dd7
4
Packit 4b6dd7
5
Packit 4b6dd7
6
Packit 4b6dd7
7
Packit 4b6dd7
8
Packit 4b6dd7
9
Packit 4b6dd7
10
Packit 4b6dd7
11
Packit 4b6dd7
12
Packit 4b6dd7
13
Packit 4b6dd7
14
Packit 4b6dd7
15
Packit 4b6dd7
16
Packit 4b6dd7
17
Packit 4b6dd7
18
Packit 4b6dd7
19
Packit 4b6dd7
20
Packit 4b6dd7
21
Packit 4b6dd7
22
Packit 4b6dd7
23
Packit 4b6dd7
24
Packit 4b6dd7
25
Packit 4b6dd7
26
Packit 4b6dd7
27
Packit 4b6dd7
        
GDataYouTubeService *service;
Packit 4b6dd7
GDataFeed *feed;
Packit 4b6dd7
GList *i;
Packit 4b6dd7
GError *error = NULL;
Packit 4b6dd7
Packit 4b6dd7
/* Create a service */
Packit 4b6dd7
service = create_youtube_service ();
Packit 4b6dd7
Packit 4b6dd7
/* Query for the top page of videos in the most popular feed */
Packit 4b6dd7
feed = gdata_youtube_service_query_standard_feed (service, GDATA_YOUTUBE_MOST_POPULAR_FEED, NULL, NULL, NULL, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (service);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error querying for most popular videos: %s", error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Iterate through the videos */
Packit 4b6dd7
for (i = gdata_feed_get_entries (feed); i != NULL; i = i->next) {
Packit 4b6dd7
    GDataYouTubeVideo *video = GDATA_YOUTUBE_VIDEO (i->data);
Packit 4b6dd7
Packit 4b6dd7
    /* Do something with the video, like insert it into the UI */
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (feed);
Packit 4b6dd7
      
Packit 4b6dd7
    
Packit 4b6dd7
  
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7

Example 14. Querying for Videos using Search Terms

Packit 4b6dd7
Packit 4b6dd7
  
Packit 4b6dd7
    
Packit 4b6dd7
      
Packit 4b6dd7
        
1
Packit 4b6dd7
2
Packit 4b6dd7
3
Packit 4b6dd7
4
Packit 4b6dd7
5
Packit 4b6dd7
6
Packit 4b6dd7
7
Packit 4b6dd7
8
Packit 4b6dd7
9
Packit 4b6dd7
10
Packit 4b6dd7
11
Packit 4b6dd7
12
Packit 4b6dd7
13
Packit 4b6dd7
14
Packit 4b6dd7
15
Packit 4b6dd7
16
Packit 4b6dd7
17
Packit 4b6dd7
18
Packit 4b6dd7
19
Packit 4b6dd7
20
Packit 4b6dd7
21
Packit 4b6dd7
22
Packit 4b6dd7
23
Packit 4b6dd7
24
Packit 4b6dd7
25
Packit 4b6dd7
26
Packit 4b6dd7
27
Packit 4b6dd7
28
Packit 4b6dd7
29
Packit 4b6dd7
30
Packit 4b6dd7
31
Packit 4b6dd7
32
Packit 4b6dd7
33
Packit 4b6dd7
        
GDataYouTubeService *service;
Packit 4b6dd7
GDataYouTubeQuery *query;
Packit 4b6dd7
GDataFeed *feed;
Packit 4b6dd7
GList *i;
Packit 4b6dd7
GError *error = NULL;
Packit 4b6dd7
Packit 4b6dd7
/* Create a service */
Packit 4b6dd7
service = create_youtube_service ();
Packit 4b6dd7
Packit 4b6dd7
/* Build a query with the given search terms, also matching only videos which are CC-licensed */
Packit 4b6dd7
query = gdata_youtube_query_new (my_space_separated_search_terms);
Packit 4b6dd7
gdata_youtube_query_set_license (query, GDATA_YOUTUBE_LICENSE_CC);
Packit 4b6dd7
Packit 4b6dd7
/* Query for the videos matching the query parameters */
Packit 4b6dd7
feed = gdata_youtube_service_query_videos (service, query, NULL, NULL, NULL, &error);
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (query);
Packit 4b6dd7
g_object_unref (service);
Packit 4b6dd7
Packit 4b6dd7
if (error != NULL) {
Packit 4b6dd7
    g_error ("Error querying for videos matching search terms ‘%s’: %s", my_space_separated_search_terms, error->message);
Packit 4b6dd7
    g_error_free (error);
Packit 4b6dd7
    return;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/* Iterate through the videos */
Packit 4b6dd7
for (i = gdata_feed_get_entries (feed); i != NULL; i = i->next) {
Packit 4b6dd7
    GDataYouTubeVideo *video = GDATA_YOUTUBE_VIDEO (i->data);
Packit 4b6dd7
Packit 4b6dd7
    /* Do something with the video, like insert it into the UI */
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (feed);
Packit 4b6dd7
      
Packit 4b6dd7
    
Packit 4b6dd7
  
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_new ()

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

Creates a new GDataYouTubeService using the given GDataAuthorizer. If authorizer

Packit 4b6dd7
 is NULL, all requests are made as an unauthenticated user.
Packit 4b6dd7
The developer_key
Packit 4b6dd7
 must be unique for your application, and as

Packit 4b6dd7
registered with Google.
Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

developer_key

Packit 4b6dd7

your application's developer API key

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

authorizer

Packit 4b6dd7

a GDataAuthorizer to authorize the service's requests, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a new GDataYouTubeService, or NULL; unref with g_object_unref()

Packit 4b6dd7
Packit 4b6dd7

Since: 0.9.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_get_primary_authorization_domain ()

Packit 4b6dd7
GDataAuthorizationDomain *
Packit 4b6dd7
gdata_youtube_service_get_primary_authorization_domain
Packit 4b6dd7
                               (void);
Packit 4b6dd7

The primary GDataAuthorizationDomain for interacting with YouTube. This will not normally need to be used, as it's used internally

Packit 4b6dd7
by the GDataYouTubeService methods. However, if using the plain GDataService methods to implement custom queries or requests which libgdata
Packit 4b6dd7
does not support natively, then this domain may be needed to authorize the requests.

Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the service's authorization domain.

Packit 4b6dd7

[transfer none]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.9.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_videos ()

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

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

Packit 4b6dd7
parameters on the query.

Packit 4b6dd7

Parameters and errors are as for gdata_service_query().

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][scope call][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataFeed of query results, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_videos_async ()

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

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

Packit 4b6dd7
parameters on the query. self
Packit 4b6dd7
 and query
Packit 4b6dd7
 are both reffed when this function is called, so can safely be freed after this function returns.

Packit 4b6dd7

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

Packit 4b6dd7

When the operation is finished, callback

Packit 4b6dd7
 will be called. You can then call gdata_service_query_finish()
Packit 4b6dd7
to get the results of the operation.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

destroy_progress_user_data

Packit 4b6dd7

the function to call when progress_callback

Packit 4b6dd7
will not be called any more, or NULL. This function will be
Packit 4b6dd7
called with progress_user_data
Packit 4b6dd7
as a parameter and can be used to free any memory allocated for it. 

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

callback

Packit 4b6dd7

a GAsyncReadyCallback to call when authentication is finished

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

user_data

Packit 4b6dd7

data to pass to the callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.9.1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_related ()

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

Queries the service for videos related to video

Packit 4b6dd7
. The algorithm determining which videos are related is on the server side.

Packit 4b6dd7

Parameters and other errors are as for gdata_service_query().

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

video

Packit 4b6dd7

a GDataYouTubeVideo for which to find related videos

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][scope call][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataFeed of query results; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_related_async ()

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

Queries the service for videos related to video

Packit 4b6dd7
. The algorithm determining which videos are related is on the server side.
Packit 4b6dd7
self
Packit 4b6dd7
 and query
Packit 4b6dd7
 are both reffed when this function is called, so can safely be freed after this function returns.

Packit 4b6dd7

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

Packit 4b6dd7

When the operation is finished, callback

Packit 4b6dd7
 will be called. You can then call gdata_service_query_finish()
Packit 4b6dd7
to get the results of the operation.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

video

Packit 4b6dd7

a GDataYouTubeVideo for which to find related videos

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

destroy_progress_user_data

Packit 4b6dd7

the function to call when progress_callback

Packit 4b6dd7
will not be called any more, or NULL. This function will be
Packit 4b6dd7
called with progress_user_data
Packit 4b6dd7
as a parameter and can be used to free any memory allocated for it. 

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

callback

Packit 4b6dd7

a GAsyncReadyCallback to call when authentication is finished

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

user_data

Packit 4b6dd7

data to pass to the callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.9.1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_standard_feed ()

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

Queries the service's standard feed_type

Packit 4b6dd7
 feed to build a GDataFeed.

Packit 4b6dd7

Note that with the port from v2 to v3 of the YouTube API in libgdata

Packit 4b6dd7
0.17.0, all feed types except GDATA_YOUTUBE_MOST_POPULAR_FEED have been
Packit 4b6dd7
deprecated. Other feed types will now transparently return
Packit 4b6dd7
GDATA_YOUTUBE_MOST_POPULAR_FEED, limited to the past 24 hours.

Packit 4b6dd7

Parameters and errors are as for gdata_service_query().

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

feed_type

Packit 4b6dd7

the feed type to query, from GDataYouTubeStandardFeedType

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][scope call][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataFeed of query results, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_query_standard_feed_async ()

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

Queries the service's standard feed_type

Packit 4b6dd7
 feed to build a GDataFeed. self
Packit 4b6dd7
 and
Packit 4b6dd7
query
Packit 4b6dd7
 are both reffed when this function is called, so can safely be freed after this function returns.

Packit 4b6dd7

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

Packit 4b6dd7

When the operation is finished, callback

Packit 4b6dd7
 will be called. You can then call gdata_service_query_finish()
Packit 4b6dd7
to get the results of the operation.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

feed_type

Packit 4b6dd7

the feed type to query, from GDataYouTubeStandardFeedType

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

query

Packit 4b6dd7

a GDataQuery with the query parameters, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_callback

Packit 4b6dd7

a GDataQueryProgressCallback to call when an entry is loaded, or NULL.

Packit 4b6dd7
[allow-none][closure progress_user_data]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

progress_user_data

Packit 4b6dd7

data to pass to the progress_callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

destroy_progress_user_data

Packit 4b6dd7

the function to call when progress_callback

Packit 4b6dd7
will not be called any more, or NULL. This function will be
Packit 4b6dd7
called with progress_user_data
Packit 4b6dd7
as a parameter and can be used to free any memory allocated for it. 

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

callback

Packit 4b6dd7

a GAsyncReadyCallback to call when authentication is finished

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

user_data

Packit 4b6dd7

data to pass to the callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.9.1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_upload_video ()

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

Uploads a video to YouTube, using the properties from video

Packit 4b6dd7
 and the file data written to the resulting GDataUploadStream.

Packit 4b6dd7

If video

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

Packit 4b6dd7

The stream returned by this function should be written to using the standard GOutputStream methods, asychronously or synchronously. Once the stream

Packit 4b6dd7
is closed (using g_output_stream_close()), gdata_youtube_service_finish_video_upload() should be called on it to parse and return the updated
Packit 4b6dd7
GDataYouTubeVideo for the uploaded video. This must be done, as video
Packit 4b6dd7
 isn't updated in-place.

Packit 4b6dd7

In order to cancel the upload, a GCancellable passed in to cancellable

Packit 4b6dd7
 must be cancelled using g_cancellable_cancel(). Cancelling the individual
Packit 4b6dd7
GOutputStream operations on the GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the
Packit 4b6dd7
“cancellable” for more details.

Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

video

Packit 4b6dd7

a GDataYouTubeVideo to insert

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

slug

Packit 4b6dd7

the filename to give to the uploaded file

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

content_type

Packit 4b6dd7

the content type of the uploaded data

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

a GCancellable for the entire upload stream, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataUploadStream to write the video data to, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.8.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_finish_video_upload ()

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

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

Packit 4b6dd7

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

Packit 4b6dd7
of the other stream methods). In such a case, NULL will be returned but error
Packit 4b6dd7
 will remain unset. error
Packit 4b6dd7
 is only set in the case that the server
Packit 4b6dd7
indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

upload_stream

Packit 4b6dd7

the GDataUploadStream from the operation

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the new GDataYouTubeVideo, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.8.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_get_categories ()

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

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

Packit 4b6dd7
enumerate the current YouTube categories.

Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

a GCancellable, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataAPPCategories, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.7.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_get_categories_async ()

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

Gets a list of the categories currently in use on YouTube. self

Packit 4b6dd7
 is reffed when this function is called, so can safely be unreffed after this
Packit 4b6dd7
function returns.

Packit 4b6dd7

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

Packit 4b6dd7

When the operation is finished, callback

Packit 4b6dd7
 will be called. You can then call gdata_youtube_service_get_categories_finish() to get the results of the
Packit 4b6dd7
operation.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

cancellable

Packit 4b6dd7

optional GCancellable object, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

callback

Packit 4b6dd7

a GAsyncReadyCallback to call when the request is finished

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

user_data

Packit 4b6dd7

data to pass to the callback

Packit 4b6dd7
function. 

Packit 4b6dd7
[closure]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.7.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_get_categories_finish ()

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

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

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

async_result

Packit 4b6dd7

a GAsyncResult

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

error

Packit 4b6dd7

a GError, or NULL

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a GDataAPPCategories, or NULL; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.7.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_youtube_service_get_developer_key ()

Packit 4b6dd7
const gchar *
Packit 4b6dd7
gdata_youtube_service_get_developer_key
Packit 4b6dd7
                               (GDataYouTubeService *self);
Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataYouTubeService

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the developer key property

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7

GDataYouTubeService

Packit 4b6dd7
typedef struct _GDataYouTubeService GDataYouTubeService;
Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

GDataYouTubeServiceClass

Packit 4b6dd7
typedef struct {
Packit 4b6dd7
} GDataYouTubeServiceClass;
Packit 4b6dd7
Packit 4b6dd7

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

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

enum GDataYouTubeServiceError

Packit 4b6dd7

Error codes for GDataYouTubeService operations.

Packit 4b6dd7
Packit 4b6dd7

Members

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_SERVICE_ERROR_API_QUOTA_EXCEEDED

Packit 4b6dd7
Packit 4b6dd7

the API request quota for this developer account has been exceeded

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_SERVICE_ERROR_ENTRY_QUOTA_EXCEEDED

Packit 4b6dd7
Packit 4b6dd7

the entry (e.g. video) quota for this user account has been exceeded

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_SERVICE_ERROR_CHANNEL_REQUIRED

Packit 4b6dd7
Packit 4b6dd7

the currently authenticated user doesn't have a YouTube channel, but the current action requires one;

Packit 4b6dd7
if this error is received, inform the user that they need a YouTube channel, and provide a link to

Packit 4b6dd7
https://www.youtube.com/create_channel
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

enum GDataYouTubeStandardFeedType

Packit 4b6dd7

Standard feed types for standard feed queries with

Packit 4b6dd7
gdata_youtube_service_query_standard_feed(). For more information, see the

Packit 4b6dd7
online
Packit 4b6dd7
documentation.
Packit 4b6dd7
Packit 4b6dd7

Members

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_TOP_RATED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the most highly rated

Packit 4b6dd7
  YouTube videos. Deprecated: 0.17.0: Google no longer supports this feed
Packit 4b6dd7
  type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_TOP_FAVORITES_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains videos most frequently

Packit 4b6dd7
  flagged as favorite videos. Deprecated: 0.17.0: Google no longer
Packit 4b6dd7
  supports this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_VIEWED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the most frequently

Packit 4b6dd7
  watched YouTube videos. Deprecated: 0.17.0: Google no longer supports
Packit 4b6dd7
  this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_POPULAR_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the most popular YouTube

Packit 4b6dd7
  videos, selected using an algorithm that combines many different signals to
Packit 4b6dd7
  determine overall popularity. As of version 0.17.0, this is the only
Packit 4b6dd7
  supported feed type.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_RECENT_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the videos most recently

Packit 4b6dd7
  submitted to YouTube. Deprecated: 0.17.0: Google no longer supports
Packit 4b6dd7
  this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_DISCUSSED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the YouTube videos

Packit 4b6dd7
  that have received the most comments. Deprecated: 0.17.0: Google no
Packit 4b6dd7
  longer supports this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_LINKED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains the YouTube videos that

Packit 4b6dd7
  receive the most links from other websites. Deprecated: 0.17.0: Google
Packit 4b6dd7
  no longer supports this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_MOST_RESPONDED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains YouTube videos that

Packit 4b6dd7
  receive the most video responses. Deprecated: 0.17.0: Google no longer
Packit 4b6dd7
  supports this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_RECENTLY_FEATURED_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains videos recently

Packit 4b6dd7
  featured on the YouTube home page or featured videos tab. Deprecated:
Packit 4b6dd7
  0.17.0: Google no longer supports this feed type, and it will return
Packit 4b6dd7
  results equivalent to GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDATA_YOUTUBE_WATCH_ON_MOBILE_FEED

Packit 4b6dd7
Packit 4b6dd7

This feed contains videos suitable for

Packit 4b6dd7
  playback on mobile devices. Deprecated: 0.17.0: Google no longer
Packit 4b6dd7
  supports this feed type, and it will return results equivalent to
Packit 4b6dd7
  GDATA_YOUTUBE_MOST_POPULAR_FEED.

Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Property Details

Packit 4b6dd7
Packit 4b6dd7

The “developer-key” property

Packit 4b6dd7
  “developer-key”            gchar *
Packit 4b6dd7

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

Packit 4b6dd7

With the port from v2 to v3 of the YouTube API in libgdata

Packit 4b6dd7
0.17.0, it might be necessary to update your application’s
Packit 4b6dd7
developer key.

Packit 4b6dd7

Flags: Read / Write / Construct Only

Packit 4b6dd7

Default value: NULL

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Generated by GTK-Doc V1.26.1
Packit 4b6dd7
</body>
Packit 4b6dd7
</html>