~ubuntu-branches/ubuntu/oneiric/libgdata/oneiric-backports

« back to all changes in this revision

Viewing changes to docs/reference/html/GDataYouTubeService.html

  • Committer: Package Import Robot
  • Author(s): Evan Broder
  • Date: 2011-11-15 21:59:48 UTC
  • mfrom: (4.1.4 experimental)
  • Revision ID: package-import@ubuntu.com-20111115215948-e17s889ocgu5fv4f
Tags: 0.10.1-1~oneiric1
Automated backport upload; no source changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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>
52
52
 
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>,
171
176
<p>
172
177
</p>
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">
177
182
    <tbody>
235
240
<p>
236
241
</p>
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">
241
246
    <tbody>
449
454
<p>
450
455
</p>
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">
455
460
    <tbody>
538
543
</div>
539
544
<hr>
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
565
570
</div>
566
571
<hr>
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>
648
653
<p>
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>.
651
657
</p>
652
658
<div class="variablelist"><table border="0">
657
663
<td>your application's developer API key</td>
658
664
</tr>
659
665
<tr>
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>
 
668
</td>
662
669
</tr>
663
670
<tr>
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>
666
673
</td>
667
674
</tr>
668
675
</tbody>
669
676
</table></div>
 
677
<p class="since">Since 0.9.0</p>
 
678
</div>
 
679
<hr>
 
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>
 
684
<p>
 
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.
 
688
</p>
 
689
<p>
 
690
The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.
 
691
</p>
 
692
<div class="variablelist"><table border="0">
 
693
<col align="left" valign="top">
 
694
<tbody><tr>
 
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>
 
697
</td>
 
698
</tr></tbody>
 
699
</table></div>
 
700
<p class="since">Since 0.9.0</p>
670
701
</div>
671
702
<hr>
672
703
<div class="refsect2">
699
730
</tr>
700
731
<tr>
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>
703
734
</td>
704
735
</tr>
705
736
<tr>
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>
708
739
</td>
709
740
</tr>
710
741
<tr>
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>
739
771
<p>
762
794
</tr>
763
795
<tr>
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>
766
798
</td>
767
799
</tr>
768
800
<tr>
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>
771
803
</td>
772
804
</tr>
773
805
<tr>
776
808
</td>
777
809
</tr>
778
810
<tr>
 
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>
 
814
</td>
 
815
</tr>
 
816
<tr>
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>
781
819
</tr>
786
824
</tr>
787
825
</tbody>
788
826
</table></div>
 
827
<p class="since">Since 0.9.1</p>
789
828
</div>
790
829
<hr>
791
830
<div class="refsect2">
823
862
</tr>
824
863
<tr>
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>
827
866
</td>
828
867
</tr>
829
868
<tr>
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>
832
871
</td>
833
872
</tr>
834
873
<tr>
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>
864
904
<p>
891
931
</tr>
892
932
<tr>
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>
895
935
</td>
896
936
</tr>
897
937
<tr>
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>
900
940
</td>
901
941
</tr>
902
942
<tr>
905
945
</td>
906
946
</tr>
907
947
<tr>
 
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>
 
951
</td>
 
952
</tr>
 
953
<tr>
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>
910
956
</tr>
915
961
</tr>
916
962
</tbody>
917
963
</table></div>
 
964
<p class="since">Since 0.9.1</p>
918
965
</div>
919
966
<hr>
920
967
<div class="refsect2">
953
1000
</tr>
954
1001
<tr>
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>
957
1004
</td>
958
1005
</tr>
959
1006
<tr>
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>
962
1009
</td>
963
1010
</tr>
964
1011
<tr>
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>
994
1042
<p>
1022
1070
</tr>
1023
1071
<tr>
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>
1026
1074
</td>
1027
1075
</tr>
1028
1076
<tr>
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>
1031
1079
</td>
1032
1080
</tr>
1033
1081
<tr>
1036
1084
</td>
1037
1085
</tr>
1038
1086
<tr>
 
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>
 
1090
</td>
 
1091
</tr>
 
1092
<tr>
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>
1041
1095
</tr>
1046
1100
</tr>
1047
1101
</tbody>
1048
1102
</table></div>
 
1103
<p class="since">Since 0.9.1</p>
1049
1104
</div>
1050
1105
<hr>
1051
1106
<div class="refsect2">
1180
1235
</tr>
1181
1236
<tr>
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>
1184
1239
</td>
1185
1240
</tr>
1186
1241
<tr>
1226
1281
</tr>
1227
1282
<tr>
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>
1230
1285
</td>
1231
1286
</tr>
1232
1287
<tr>
1311
1366
<p>
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>.
1313
1368
</p>
1314
 
<p>
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>.
1316
 
</p>
1317
1369
<p>Default value: NULL</p>
1318
1370
</div>
1319
1371
</div>