5
5
<title>GDataYouTubeService</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="GData Reference Manual">
8
<link rel="up" href="ch11.html" title="YouTube API">
9
<link rel="prev" href="ch11.html" title="YouTube API">
8
<link rel="up" href="ch13.html" title="YouTube API">
9
<link rel="prev" href="ch13.html" title="YouTube API">
10
10
<link rel="next" href="GDataYouTubeQuery.html" title="GDataYouTubeQuery">
11
11
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
16
<tr valign="middle">
17
<td><a accesskey="p" href="ch11.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="ch11.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
17
<td><a accesskey="p" href="ch13.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="ch13.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
20
<th width="100%" align="center">GData Reference Manual</th>
21
21
<td><a accesskey="n" href="GDataYouTubeQuery.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
53
53
<a class="link" href="GDataYouTubeService.html#GDataYouTubeService-struct" title="GDataYouTubeService">GDataYouTubeService</a>;
54
54
<a class="link" href="GDataYouTubeService.html#GDataYouTubeServiceClass" title="GDataYouTubeServiceClass">GDataYouTubeServiceClass</a>;
55
enum <a class="link" href="GDataYouTubeService.html#GDataYouTubeServiceError">GDataYouTubeServiceError</a>;
56
enum <a class="link" href="GDataYouTubeService.html#GDataYouTubeStandardFeedType">GDataYouTubeStandardFeedType</a>;
55
enum <a class="link" href="GDataYouTubeService.html#GDataYouTubeServiceError-enum" title="enum GDataYouTubeServiceError">GDataYouTubeServiceError</a>;
56
enum <a class="link" href="GDataYouTubeService.html#GDataYouTubeStandardFeedType-enum" title="enum GDataYouTubeStandardFeedType">GDataYouTubeStandardFeedType</a>;
57
57
<a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="returnvalue">GDataYouTubeService</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-new" title="gdata_youtube_service_new ()">gdata_youtube_service_new</a> (<em class="parameter"><code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *developer_key</code></em>,
58
<em class="parameter"><code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *client_id</code></em>);
58
<em class="parameter"><code><a class="link" href="GDataAuthorizer.html" title="GDataAuthorizer"><span class="type">GDataAuthorizer</span></a> *authorizer</code></em>);
59
<a class="link" href="GDataAuthorizationDomain.html" title="GDataAuthorizationDomain"><span class="returnvalue">GDataAuthorizationDomain</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-get-primary-authorization-domain" title="gdata_youtube_service_get_primary_authorization_domain ()">gdata_youtube_service_get_primary_authorization_domain</a>
60
(<em class="parameter"><code><span class="type">void</span></code></em>);
59
61
<a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-query-videos" title="gdata_youtube_service_query_videos ()">gdata_youtube_service_query_videos</a> (<em class="parameter"><code><a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a> *self</code></em>,
60
62
<em class="parameter"><code><a class="link" href="GDataQuery.html" title="GDataQuery"><span class="type">GDataQuery</span></a> *query</code></em>,
61
63
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
68
70
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
69
71
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
70
72
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
73
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
71
74
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
72
75
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
73
76
<a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-query-related" title="gdata_youtube_service_query_related ()">gdata_youtube_service_query_related</a> (<em class="parameter"><code><a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a> *self</code></em>,
84
87
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
85
88
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
86
89
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
90
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
87
91
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
88
92
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
89
93
<a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-query-standard-feed" title="gdata_youtube_service_query_standard_feed ()">gdata_youtube_service_query_standard_feed</a>
101
105
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
102
106
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
103
107
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
108
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
104
109
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
105
110
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
106
111
<a class="link" href="GDataUploadStream.html" title="GDataUploadStream"><span class="returnvalue">GDataUploadStream</span></a> * <a class="link" href="GDataYouTubeService.html#gdata-youtube-service-upload-video" title="gdata_youtube_service_upload_video ()">gdata_youtube_service_upload_video</a> (<em class="parameter"><code><a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a> *self</code></em>,
173
178
<div class="example">
174
<a name="id517838"></a><p class="title"><b>Example 5. Getting a Localized List of YouTube Categories</b></p>
179
<a name="id633953"></a><p class="title"><b>Example 7. Getting a Localized List of YouTube Categories</b></p>
175
180
<div class="example-contents">
176
181
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
237
242
<div class="example">
238
<a name="id517883"></a><p class="title"><b>Example 6. Uploading a Video from Disk</b></p>
243
<a name="id633999"></a><p class="title"><b>Example 8. Uploading a Video from Disk</b></p>
239
244
<div class="example-contents">
240
245
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
451
456
<div class="example">
452
<a name="id517970"></a><p class="title"><b>Example 7. Querying for Videos from a Standard Feed</b></p>
457
<a name="id634086"></a><p class="title"><b>Example 9. Querying for Videos from a Standard Feed</b></p>
453
458
<div class="example-contents">
454
459
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
540
545
<div class="refsect2">
541
<a name="GDataYouTubeServiceError"></a><h3>enum GDataYouTubeServiceError</h3>
546
<a name="GDataYouTubeServiceError-enum"></a><h3>enum GDataYouTubeServiceError</h3>
542
547
<pre class="programlisting">typedef enum {
543
548
GDATA_YOUTUBE_SERVICE_ERROR_API_QUOTA_EXCEEDED,
544
549
GDATA_YOUTUBE_SERVICE_ERROR_ENTRY_QUOTA_EXCEEDED
567
572
<div class="refsect2">
568
<a name="GDataYouTubeStandardFeedType"></a><h3>enum GDataYouTubeStandardFeedType</h3>
573
<a name="GDataYouTubeStandardFeedType-enum"></a><h3>enum GDataYouTubeStandardFeedType</h3>
569
574
<pre class="programlisting">typedef enum {
570
575
GDATA_YOUTUBE_TOP_RATED_FEED,
571
576
GDATA_YOUTUBE_TOP_FAVORITES_FEED,
644
649
<div class="refsect2">
645
650
<a name="gdata-youtube-service-new"></a><h3>gdata_youtube_service_new ()</h3>
646
651
<pre class="programlisting"><a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="returnvalue">GDataYouTubeService</span></a> * gdata_youtube_service_new (<em class="parameter"><code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *developer_key</code></em>,
647
<em class="parameter"><code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *client_id</code></em>);</pre>
652
<em class="parameter"><code><a class="link" href="GDataAuthorizer.html" title="GDataAuthorizer"><span class="type">GDataAuthorizer</span></a> *authorizer</code></em>);</pre>
649
Creates a new <a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a>. The <em class="parameter"><code>developer_key</code></em> and <em class="parameter"><code>client_id</code></em> must be unique for your application, and as
654
Creates a new <a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a> using the given <a class="link" href="GDataAuthorizer.html" title="GDataAuthorizer"><span class="type">GDataAuthorizer</span></a>. If <em class="parameter"><code>authorizer</code></em> is <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, all requests are made as an unauthenticated user.
655
The <em class="parameter"><code>developer_key</code></em> must be unique for your application, and as
650
656
<a class="ulink" href="http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Developer_Key" target="_top">registered with Google</a>.
652
658
<div class="variablelist"><table border="0">
657
663
<td>your application's developer API key</td>
660
<td><p><span class="term"><em class="parameter"><code>client_id</code></em> :</span></p></td>
661
<td>your application's client ID</td>
666
<td><p><span class="term"><em class="parameter"><code>authorizer</code></em> :</span></p></td>
667
<td>a <a class="link" href="GDataAuthorizer.html" title="GDataAuthorizer"><span class="type">GDataAuthorizer</span></a> to authorize the service's requests, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
664
671
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
665
<td>a new <a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
672
<td>a new <a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="/opt/gnome3/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>
677
<p class="since">Since 0.9.0</p>
680
<div class="refsect2">
681
<a name="gdata-youtube-service-get-primary-authorization-domain"></a><h3>gdata_youtube_service_get_primary_authorization_domain ()</h3>
682
<pre class="programlisting"><a class="link" href="GDataAuthorizationDomain.html" title="GDataAuthorizationDomain"><span class="returnvalue">GDataAuthorizationDomain</span></a> * gdata_youtube_service_get_primary_authorization_domain
683
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
685
The primary <a class="link" href="GDataAuthorizationDomain.html" title="GDataAuthorizationDomain"><span class="type">GDataAuthorizationDomain</span></a> for interacting with YouTube. This will not normally need to be used, as it's used internally
686
by the <a class="link" href="GDataYouTubeService.html" title="GDataYouTubeService"><span class="type">GDataYouTubeService</span></a> methods. However, if using the plain <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> methods to implement custom queries or requests which libgdata
687
does not support natively, then this domain may be needed to authorize the requests.
690
The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.
692
<div class="variablelist"><table border="0">
693
<col align="left" valign="top">
695
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
696
<td>the service's authorization domain. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
700
<p class="since">Since 0.9.0</p>
672
703
<div class="refsect2">
701
732
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
702
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
733
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
706
737
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
707
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
738
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
734
765
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
735
766
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
736
767
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
768
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
737
769
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
738
770
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
764
796
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
765
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
797
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
769
801
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
770
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
802
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
811
<td><p><span class="term"><em class="parameter"><code>destroy_progress_user_data</code></em> :</span></p></td>
812
<td>the function to call when <em class="parameter"><code>progress_callback</code></em> will not be called any more, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This function will be
813
called with <em class="parameter"><code>progress_user_data</code></em> as a parameter and can be used to free any memory allocated for it. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
779
817
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
780
818
<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when authentication is finished</td>
825
864
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
826
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
865
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
830
869
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
831
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
870
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
859
898
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
860
899
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
861
900
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
901
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
862
902
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
863
903
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
893
933
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
894
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
934
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
898
938
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
899
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
939
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
948
<td><p><span class="term"><em class="parameter"><code>destroy_progress_user_data</code></em> :</span></p></td>
949
<td>the function to call when <em class="parameter"><code>progress_callback</code></em> will not be called any more, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This function will be
950
called with <em class="parameter"><code>progress_user_data</code></em> as a parameter and can be used to free any memory allocated for it. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
908
954
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
909
955
<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when authentication is finished</td>
955
1002
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
956
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1003
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
960
1007
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
961
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
1008
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
989
1036
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
990
1037
<em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
991
1038
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
1039
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
992
1040
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
993
1041
<em class="parameter"><code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1024
1072
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1025
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1073
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1029
1077
<td><p><span class="term"><em class="parameter"><code>progress_callback</code></em> :</span></p></td>
1030
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1078
<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when an entry is loaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym> progress_user_data]</span>
1087
<td><p><span class="term"><em class="parameter"><code>destroy_progress_user_data</code></em> :</span></p></td>
1088
<td>the function to call when <em class="parameter"><code>progress_callback</code></em> will not be called any more, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This function will be
1089
called with <em class="parameter"><code>progress_user_data</code></em> as a parameter and can be used to free any memory allocated for it. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1039
1093
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1040
1094
<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when authentication is finished</td>
1182
1237
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1183
<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1238
<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1228
1283
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1229
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1284
<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html"><span class="type">GCancellable</span></a> object, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1312
1367
The developer key your application has registered with the YouTube API. For more information, see the <a class="ulink" href="http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Developer_Key" target="_top">online documentation</a>.
1315
The matching <a class="link" href="GDataService.html#GDataService--client-id" title='The "client-id" property'><span class="type">"client-id"</span></a> property belongs to <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a>.
1317
1369
<p>Default value: NULL</p>