Blob Blame History Raw
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GDataCommentable: GData Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GData Reference Manual">
<link rel="up" href="ch06.html" title="Comment API">
<link rel="prev" href="ch06.html" title="Comment API">
<link rel="next" href="GDataComment.html" title="GDataComment">
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GDataCommentable.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GDataCommentable.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span> 
                  <a href="#GDataCommentable.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_implementations">  <span class="dim">|</span> 
                  <a href="#GDataCommentable.implementations" class="shortcut">Known Implementations</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch06.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ch06.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GDataComment.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GDataCommentable"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GDataCommentable.top_of_page"></a>GDataCommentable</span></h2>
<p>GDataCommentable — GData commentable interface</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GDataCommentable.stability-level"></a><h2>Stability Level</h2>
<acronym title="The intention of a Stable interface is to enable arbitrary third parties to
develop applications to these interfaces, release them, and have confidence that
they will run on all minor releases of the product (after the one in which the
interface was introduced, and within the same major release). Even at a major
release, incompatible changes are expected to be rare, and to have strong
justifications.
"><span class="acronym">Stable</span></acronym>, unless otherwise indicated
</div>
<div class="refsect1">
<a name="GDataCommentable.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-query-comments" title="gdata_commentable_query_comments ()">gdata_commentable_query_comments</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-query-comments-async" title="gdata_commentable_query_comments_async ()">gdata_commentable_query_comments_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-query-comments-finish" title="gdata_commentable_query_comments_finish ()">gdata_commentable_query_comments_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataComment.html" title="GDataComment"><span class="returnvalue">GDataComment</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment" title="gdata_commentable_insert_comment ()">gdata_commentable_insert_comment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment-async" title="gdata_commentable_insert_comment_async ()">gdata_commentable_insert_comment_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataComment.html" title="GDataComment"><span class="returnvalue">GDataComment</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment-finish" title="gdata_commentable_insert_comment_finish ()">gdata_commentable_insert_comment_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment" title="gdata_commentable_delete_comment ()">gdata_commentable_delete_comment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment-async" title="gdata_commentable_delete_comment_async ()">gdata_commentable_delete_comment_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment-finish" title="gdata_commentable_delete_comment_finish ()">gdata_commentable_delete_comment_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataCommentable.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataCommentable.html#GDataCommentable-struct" title="GDataCommentable">GDataCommentable</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataCommentable.html#GDataCommentableInterface" title="GDataCommentableInterface">GDataCommentableInterface</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataCommentable.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="/opt/gnome/install/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
    <span class="lineart">╰──</span> GDataCommentable
</pre>
</div>
<div class="refsect1">
<a name="GDataCommentable.prerequisites"></a><h2>Prerequisites</h2>
<p>
GDataCommentable requires
 <a class="link" href="GDataEntry.html" title="GDataEntry">GDataEntry</a>.</p>
</div>
<div class="refsect1">
<a name="GDataCommentable.implementations"></a><h2>Known Implementations</h2>
<p>
GDataCommentable is implemented by
 <a class="link" href="GDataPicasaWebFile.html" title="GDataPicasaWebFile">GDataPicasaWebFile</a> and  <a class="link" href="GDataYouTubeVideo.html" title="GDataYouTubeVideo">GDataYouTubeVideo</a>.</p>
</div>
<div class="refsect1">
<a name="GDataCommentable.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gdata/gdata-commentable.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GDataCommentable.description"></a><h2>Description</h2>
<p><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> is an interface which can be implemented by commentable objects: objects which support having comments added to them by users,
such as videos and photos.</p>
<p>Comments may be queried, added and deleted. Note that they may not be edited.</p>
<p><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> objects may not support all operations on comments, on an instance-by-instance basis (i.e. it's an invalid assumption that if,
for example, one <a class="link" href="GDataYouTubeVideo.html" title="GDataYouTubeVideo"><span class="type">GDataYouTubeVideo</span></a> doesn't support adding comments all other <a class="link" href="GDataYouTubeVideo.html" title="GDataYouTubeVideo"><span class="type">GDataYouTubeVideo</span></a>s don't support adding comments either).
Specific documentation for a particular type of <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> may state otherwise, though.</p>
<div class="example">
<a name="id-1.3.6.2.10.5"></a><p class="title"><b>Example 10. Querying for Comments</b></p>
<div class="example-contents">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GDataService</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">service</span><span class="symbol">;</span>
<span class="usertype">GDataCommentable</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">commentable</span><span class="symbol">;</span>

<span class="comment">/* Create a service */</span>
<span class="normal">service </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_service</span><span class="normal"> </span><span class="symbol">();</span>

<span class="comment">/* Retrieve the GDataCommentable which is going to be queried. This may be, for example, a GDataYouTubeVideo. */</span>
<span class="normal">commentable </span><span class="symbol">=</span><span class="normal"> </span><span class="function">get_commentable</span><span class="normal"> </span><span class="symbol">();</span>

<span class="comment">/* Start the async. query for the comments. */</span>
<span class="function"><a href="GDataCommentable.html#gdata-commentable-query-comments-async">gdata_commentable_query_comments_async</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">commentable</span><span class="symbol">,</span><span class="normal"> service</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GAsyncReadyCallback</span><span class="symbol">)</span><span class="normal"> query_comments_cb</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>

<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">commentable</span><span class="symbol">);</span>

<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<span class="function">query_comments_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GDataCommentable</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">commentable</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GAsyncResult</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">result</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal">    </span><span class="usertype">GDataFeed</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">comment_feed</span><span class="symbol">;</span>
<span class="normal">    </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">comments</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">i</span><span class="symbol">;</span>
<span class="normal">    </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>

<span class="normal">    comment_feed </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GDataCommentable.html#gdata-commentable-query-comments-finish">gdata_commentable_query_comments_finish</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">commentable</span><span class="symbol">,</span><span class="normal"> result</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span>

<span class="normal">    </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal">        </span><span class="comment">/* Error! */</span>
<span class="normal">        </span><span class="function"><a href="../glib/glib-Message-Logging.html#g-error">g_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Error querying comments: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
<span class="normal">        </span><span class="function"><a href="../glib/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
<span class="normal">        </span><span class="keyword">return</span><span class="symbol">;</span>
<span class="normal">    </span><span class="cbracket">}</span>

<span class="normal">    </span><span class="comment">/* Examine the comments. */</span>
<span class="normal">    comments </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GDataFeed.html#gdata-feed-get-entries">gdata_feed_get_entries</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">comment_feed</span><span class="symbol">);</span>
<span class="normal">    </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> comments</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">=</span><span class="normal"> i</span><span class="symbol">-&gt;</span><span class="normal">next</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal">        </span><span class="comment">/* Note that this will actually be a subclass of GDataComment,</span>
<span class="comment">         * such as GDataYouTubeComment or GDataPicasaWebComment. */</span>
<span class="normal">        </span><span class="usertype">GDataComment</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">comment </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GDATA_COMMENT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">);</span>
<span class="normal">        </span><span class="usertype">GDataAuthor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">author</span><span class="symbol">;</span>

<span class="normal">        </span><span class="comment">/* Note that in practice it might not always be safe to assume that a comment always has an author. */</span>
<span class="normal">        author </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GDATA_AUTHOR</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GDataEntry.html#gdata-entry-get-authors">gdata_entry_get_authors</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDATA_ENTRY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">comment</span><span class="symbol">))-&gt;</span><span class="normal">data</span><span class="symbol">);</span>

<span class="normal">        </span><span class="function"><a href="../glib/glib-Message-Logging.html#g-message">g_message</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Comment by %s (%s): %s"</span><span class="symbol">,</span>
<span class="normal">                   </span><span class="function"><a href="GDataAuthor.html#gdata-author-get-name">gdata_author_get_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">author</span><span class="symbol">),</span>
<span class="normal">                   </span><span class="function"><a href="GDataAuthor.html#gdata-author-get-uri">gdata_author_get_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">author</span><span class="symbol">),</span>
<span class="normal">                   </span><span class="function"><a href="GDataEntry.html#gdata-entry-get-content">gdata_entry_get_content</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDATA_ENTRY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">comment</span><span class="symbol">)));</span>
<span class="normal">    </span><span class="cbracket">}</span>

<span class="normal">    </span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">comment_feed</span><span class="symbol">);</span>
<span class="cbracket">}</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

</div>
<br class="example-break">
</div>
<div class="refsect1">
<a name="GDataCommentable.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gdata-commentable-query-comments"></a><h3>gdata_commentable_query_comments ()</h3>
<pre class="programlisting"><a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> *
gdata_commentable_query_comments (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataQuery.html" title="GDataQuery"><span class="type">GDataQuery</span></a> *query</code></em>,
                                  <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
                                  <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
                                  <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Retrieves a <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> containing the <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>s representing the comments on the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> which match the given <em class="parameter"><code>query</code></em>
.</p>
<p>If the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> doesn't support commenting, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned and <em class="parameter"><code>error</code></em>
 will be set to <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-FORBIDDEN:CAPS"><code class="literal">GDATA_SERVICE_ERROR_FORBIDDEN</code></a>. This is in
contrast to if it does support commenting but hasn't had any comments added yet, in which case an empty <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> will be returned and no error
will be set.</p>
<div class="refsect3">
<a name="gdata-commentable-query-comments.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> representing the service with which the object's comments will be manipulated</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>query</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataQuery.html" title="GDataQuery"><span class="type">GDataQuery</span></a> with query parameters, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_callback</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when a comment is loaded, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>progress_callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-query-comments.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> of <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-query-comments-async"></a><h3>gdata_commentable_query_comments_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_commentable_query_comments_async
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataQuery.html" title="GDataQuery"><span class="type">GDataQuery</span></a> *query</code></em>,
                                <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> progress_callback</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> progress_user_data</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_progress_user_data</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Retrieves a <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> containing the <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>s representing the comments on the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> which match the given <em class="parameter"><code>query</code></em>
.
<em class="parameter"><code>self</code></em>
, <em class="parameter"><code>service</code></em>
 and <em class="parameter"><code>query</code></em>
 are all reffed when this method is called, so can safely be freed after this method returns.</p>
<p>For more details, see <a class="link" href="GDataCommentable.html#gdata-commentable-query-comments" title="gdata_commentable_query_comments ()"><code class="function">gdata_commentable_query_comments()</code></a>, which is the synchronous version of this method.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
 will be called. You can then call <a class="link" href="GDataCommentable.html#gdata-commentable-query-comments-finish" title="gdata_commentable_query_comments_finish ()"><code class="function">gdata_commentable_query_comments_finish()</code></a> to get the results of the
operation.</p>
<div class="refsect3">
<a name="gdata-commentable-query-comments-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> representing the service with which the object's comments will be manipulated</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>query</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataQuery.html" title="GDataQuery"><span class="type">GDataQuery</span></a> with query parameters, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_callback</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()"><span class="type">GDataQueryProgressCallback</span></a> to call when a comment is loaded,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><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 until the GDestroyNotify argument is called."><span class="acronym">scope notified</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></td>
</tr>
<tr>
<td class="parameter_name"><p>progress_user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>progress_callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>destroy_progress_user_data</p></td>
<td class="parameter_description"><p>a function to call when <em class="parameter"><code>progress_callback</code></em>
will not be called any more, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; this function will be
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. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the query is finished</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-query-comments-finish"></a><h3>gdata_commentable_query_comments_finish ()</h3>
<pre class="programlisting"><a class="link" href="GDataFeed.html" title="GDataFeed"><span class="returnvalue">GDataFeed</span></a> *
gdata_commentable_query_comments_finish
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finishes an asynchronous comment query operation started with <a class="link" href="GDataCommentable.html#gdata-commentable-query-comments-async" title="gdata_commentable_query_comments_async ()"><code class="function">gdata_commentable_query_comments_async()</code></a>.</p>
<div class="refsect3">
<a name="gdata-commentable-query-comments-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-query-comments-finish.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> of <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-insert-comment"></a><h3>gdata_commentable_insert_comment ()</h3>
<pre class="programlisting"><a class="link" href="GDataComment.html" title="GDataComment"><span class="returnvalue">GDataComment</span></a> *
gdata_commentable_insert_comment (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a> *comment_</code></em>,
                                  <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                  <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Adds <em class="parameter"><code>comment</code></em>
 to the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a>.</p>
<p>If the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> doesn't support commenting, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned and <em class="parameter"><code>error</code></em>
 will be set to <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-FORBIDDEN:CAPS"><code class="literal">GDATA_SERVICE_ERROR_FORBIDDEN</code></a>.</p>
<div class="refsect3">
<a name="gdata-commentable-insert-comment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> with which the comment will be added</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>comment_</p></td>
<td class="parameter_description"><p>a new comment to be added to the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-insert-comment.returns"></a><h4>Returns</h4>
<p>the added <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-insert-comment-async"></a><h3>gdata_commentable_insert_comment_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_commentable_insert_comment_async
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a> *comment_</code></em>,
                                <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Adds <em class="parameter"><code>comment</code></em>
 to the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a>. <em class="parameter"><code>self</code></em>
, <em class="parameter"><code>service</code></em>
 and <em class="parameter"><code>comment_</code></em>
 are all reffed when this method is called, so can safely be freed after this
method returns.</p>
<p>For more details, see <a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment" title="gdata_commentable_insert_comment ()"><code class="function">gdata_commentable_insert_comment()</code></a>, which is the synchronous version of this method.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
 will be called. You can then call <a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment-finish" title="gdata_commentable_insert_comment_finish ()"><code class="function">gdata_commentable_insert_comment_finish()</code></a> to get the results of the
operation.</p>
<div class="refsect3">
<a name="gdata-commentable-insert-comment-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> with which the comment will be added</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>comment_</p></td>
<td class="parameter_description"><p>a new comment to be added to the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the operation is finished</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-insert-comment-finish"></a><h3>gdata_commentable_insert_comment_finish ()</h3>
<pre class="programlisting"><a class="link" href="GDataComment.html" title="GDataComment"><span class="returnvalue">GDataComment</span></a> *
gdata_commentable_insert_comment_finish
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finishes an asynchronous comment insertion operation started with <a class="link" href="GDataCommentable.html#gdata-commentable-insert-comment-async" title="gdata_commentable_insert_comment_async ()"><code class="function">gdata_commentable_insert_comment_async()</code></a>.</p>
<div class="refsect3">
<a name="gdata-commentable-insert-comment-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-insert-comment-finish.returns"></a><h4>Returns</h4>
<p>the added <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-delete-comment"></a><h3>gdata_commentable_delete_comment ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_commentable_delete_comment (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                  <em class="parameter"><code><a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a> *comment_</code></em>,
                                  <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                  <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Deletes <em class="parameter"><code>comment</code></em>
 from the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a>.</p>
<p>If the given <em class="parameter"><code>comment</code></em>
 isn't deletable (either because the service doesn't support deleting comments at all, or because this particular comment
is not deletable due to having insufficient permissions), <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-FORBIDDEN:CAPS"><code class="literal">GDATA_SERVICE_ERROR_FORBIDDEN</code></a> will be set in <em class="parameter"><code>error</code></em>
 and <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
<div class="refsect3">
<a name="gdata-commentable-delete-comment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> with which the comment will be deleted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>comment_</p></td>
<td class="parameter_description"><p>a comment to be deleted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-delete-comment.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the comment was successfully deleted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-delete-comment-async"></a><h3>gdata_commentable_delete_comment_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_commentable_delete_comment_async
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> *service</code></em>,
                                <em class="parameter"><code><a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a> *comment_</code></em>,
                                <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Deletes <em class="parameter"><code>comment</code></em>
 from the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a>. <em class="parameter"><code>self</code></em>
, <em class="parameter"><code>service</code></em>
 and <em class="parameter"><code>comment_</code></em>
 are all reffed when this method is called, so can safely be freed after
this method returns.</p>
<p>For more details, see <a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment" title="gdata_commentable_delete_comment ()"><code class="function">gdata_commentable_delete_comment()</code></a>, which is the synchronous version of this method.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
 will be called. You can then call <a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment-finish" title="gdata_commentable_delete_comment_finish ()"><code class="function">gdata_commentable_delete_comment_finish()</code></a> to get the results of the
operation.</p>
<div class="refsect3">
<a name="gdata-commentable-delete-comment-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataService.html" title="GDataService"><span class="type">GDataService</span></a> with which the comment will be deleted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>comment_</p></td>
<td class="parameter_description"><p>a comment to be deleted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the operation is finished</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-commentable-delete-comment-finish"></a><h3>gdata_commentable_delete_comment_finish ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_commentable_delete_comment_finish
                               (<em class="parameter"><code><a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> *self</code></em>,
                                <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finishes an asynchronous comment deletion operation started with <a class="link" href="GDataCommentable.html#gdata-commentable-delete-comment-async" title="gdata_commentable_delete_comment_async ()"><code class="function">gdata_commentable_delete_comment_async()</code></a>.</p>
<div class="refsect3">
<a name="gdata-commentable-delete-comment-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-commentable-delete-comment-finish.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the comment was successfully deleted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="GDataCommentable.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GDataCommentable-struct"></a><h3>GDataCommentable</h3>
<pre class="programlisting">typedef struct _GDataCommentable GDataCommentable;</pre>
<p>All the fields in the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> structure are private and should never be accessed directly</p>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataCommentableInterface"></a><h3>GDataCommentableInterface</h3>
<pre class="programlisting">typedef struct {
	GTypeInterface parent;

	GType comment_type;

	GDataAuthorizationDomain *(*get_authorization_domain) (GDataCommentable *self);

	gchar *(*get_query_comments_uri) (GDataCommentable *self);
	gchar *(*get_insert_comment_uri) (GDataCommentable *self, GDataComment *comment);
	gboolean (*is_comment_deletable) (GDataCommentable *self, GDataComment *comment);
} GDataCommentableInterface;
</pre>
<p>The interface structure for the <a class="link" href="GDataCommentable.html" title="GDataCommentable"><span class="type">GDataCommentable</span></a> interface.</p>
<div class="refsect3">
<a name="GDataCommentableInterface.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><a href="../gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GDataCommentableInterface.parent"></a>parent</code></em>;</p></td>
<td class="struct_member_description"><p>the parent type</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GDataCommentableInterface.comment-type"></a>comment_type</code></em>;</p></td>
<td class="struct_member_description"><p>the <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the comment class (subclass of <a class="link" href="GDataComment.html" title="GDataComment"><span class="type">GDataComment</span></a>) to use for query results from this commentable object</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GDataCommentableInterface.get-authorization-domain"></a>get_authorization_domain</code></em> ()</p></td>
<td class="struct_member_description"><p>a function to return the <a class="link" href="GDataAuthorizationDomain.html" title="GDataAuthorizationDomain"><span class="type">GDataAuthorizationDomain</span></a> to be used for all operations on the comments
belonging to this commentable object; not implementing this function is equivalent to returning <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> from it, which signifies that operations on the
comments don't require authorization. </p></td>
<td class="struct_member_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GDataCommentableInterface.get-query-comments-uri"></a>get_query_comments_uri</code></em> ()</p></td>
<td class="struct_member_description"><p>a function that returns the URI of a <a class="link" href="GDataFeed.html" title="GDataFeed"><span class="type">GDataFeed</span></a> of comments from a commentable object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the given commentable
object doesn't support commenting; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GDataCommentableInterface.get-insert-comment-uri"></a>get_insert_comment_uri</code></em> ()</p></td>
<td class="struct_member_description"><p>a function that returns the URI to add new comments to the commentable object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the given commentable object
doesn't support adding comments; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GDataCommentableInterface.is-comment-deletable"></a>is_comment_deletable</code></em> ()</p></td>
<td class="struct_member_description"><p>a function that returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given comment may be deleted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix13.html#api-index-0.10.0">0.10.0</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.26.1</div>
</body>
</html>