~ubuntu-branches/ubuntu/natty/libgdata/natty-updates

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

Committer: Bazaar Package Importer
Author(s): Robert Ancell
Date: 2011-01-05 11:09:00 UTC
mfrom: (1.1.6 upstream)
Revision ID: james.westby@ubuntu.com-20110105110900-gkjnbslnr18s45us

Tags: 0.8.0-0ubuntu1

* New upstream release
* debian/control:
  - Use gir1.2 packages
  - Use standards version 3.9.1
  - Add Vcs-Bzr link
  - Rename libgdata10 to libgdata11
* debian/rules:
  - Drop simple-patchsys.mk
* debian/source:
  - Use source version 3.0

files added:
.pc

.pc/.version

.pc/99_ltmain_as-needed.patch

.pc/99_ltmain_as-needed.patch/ltmain.sh

.pc/applied-patches

debian/gir1.2-gdata-0.0.install

debian/libgdata11.install

debian/patches/series

debian/source

debian/source/format

docs/reference/cancellation.dia

docs/reference/cancellation.png

docs/reference/data-flow.dia

docs/reference/html/cancellation.png

gdata/tests/streams.c

mkinstalldirs

po/ca@valencia.po

files removed:
debian/gir1.0-gdata-0.0.install

debian/libgdata10.install

files modified:
ChangeLog

Makefile.in

NEWS

aclocal.m4

config.h.in

configure

configure.ac

debian/changelog

debian/control

debian/control.in

debian/patches/99_ltmain_as-needed.patch

debian/rules

docs/Makefile.in

docs/reference/Makefile.am

docs/reference/Makefile.in

docs/reference/gdata-overview.xml

docs/reference/gdata-sections.txt

docs/reference/html/GDataAPPCategories.html

docs/reference/html/GDataAccessHandler.html

docs/reference/html/GDataAccessRule.html

docs/reference/html/GDataAuthor.html

docs/reference/html/GDataBatchOperation.html

docs/reference/html/GDataBatchable.html

docs/reference/html/GDataCalendarCalendar.html

docs/reference/html/GDataCalendarEvent.html

docs/reference/html/GDataCalendarFeed.html

docs/reference/html/GDataCalendarQuery.html

docs/reference/html/GDataCalendarService.html

docs/reference/html/GDataCategory.html

docs/reference/html/GDataComparable.html

docs/reference/html/GDataContactsContact.html

docs/reference/html/GDataContactsGroup.html

docs/reference/html/GDataContactsQuery.html

docs/reference/html/GDataContactsService.html

docs/reference/html/GDataDocumentsDocument.html

docs/reference/html/GDataDocumentsEntry.html

docs/reference/html/GDataDocumentsFeed.html

docs/reference/html/GDataDocumentsFolder.html

docs/reference/html/GDataDocumentsPresentation.html

docs/reference/html/GDataDocumentsQuery.html

docs/reference/html/GDataDocumentsService.html

docs/reference/html/GDataDocumentsSpreadsheet.html

docs/reference/html/GDataDocumentsText.html

docs/reference/html/GDataDownloadStream.html

docs/reference/html/GDataEntry.html

docs/reference/html/GDataFeed.html

docs/reference/html/GDataGContactCalendar.html

docs/reference/html/GDataGContactEvent.html

docs/reference/html/GDataGContactExternalID.html

docs/reference/html/GDataGContactJot.html

docs/reference/html/GDataGContactLanguage.html

docs/reference/html/GDataGContactRelation.html

docs/reference/html/GDataGContactWebsite.html

docs/reference/html/GDataGDEmailAddress.html

docs/reference/html/GDataGDIMAddress.html

docs/reference/html/GDataGDName.html

docs/reference/html/GDataGDOrganization.html

docs/reference/html/GDataGDPhoneNumber.html

docs/reference/html/GDataGDPostalAddress.html

docs/reference/html/GDataGDReminder.html

docs/reference/html/GDataGDWhen.html

docs/reference/html/GDataGDWhere.html

docs/reference/html/GDataGDWho.html

docs/reference/html/GDataGenerator.html

docs/reference/html/GDataLink.html

docs/reference/html/GDataMediaCategory.html

docs/reference/html/GDataMediaContent.html

docs/reference/html/GDataMediaCredit.html

docs/reference/html/GDataMediaThumbnail.html

docs/reference/html/GDataParsable.html

docs/reference/html/GDataPicasaWebAlbum.html

docs/reference/html/GDataPicasaWebFeed.html

docs/reference/html/GDataPicasaWebFile.html

docs/reference/html/GDataPicasaWebQuery.html

docs/reference/html/GDataPicasaWebService.html

docs/reference/html/GDataPicasaWebUser.html

docs/reference/html/GDataQuery.html

docs/reference/html/GDataService.html

docs/reference/html/GDataUploadStream.html

docs/reference/html/GDataYouTubeCategory.html

docs/reference/html/GDataYouTubeContent.html

docs/reference/html/GDataYouTubeCredit.html

docs/reference/html/GDataYouTubeQuery.html

docs/reference/html/GDataYouTubeService.html

docs/reference/html/GDataYouTubeState.html

docs/reference/html/GDataYouTubeVideo.html

docs/reference/html/api-index-full.html

docs/reference/html/ch01.html

docs/reference/html/ch02.html

docs/reference/html/ch03.html

docs/reference/html/ch04.html

docs/reference/html/ch05.html

docs/reference/html/ch06.html

docs/reference/html/ch07.html

docs/reference/html/ch08.html

docs/reference/html/ch09.html

docs/reference/html/ch10.html

docs/reference/html/ch11.html

docs/reference/html/ch12.html

docs/reference/html/ch13.html

docs/reference/html/ch14.html

docs/reference/html/ch15.html

docs/reference/html/gdata-GData-Types.html

docs/reference/html/gdata-overview.html

docs/reference/html/gdata-running.html

docs/reference/html/gdata.devhelp

docs/reference/html/gdata.devhelp2

docs/reference/html/index.html

docs/reference/html/index.sgml

docs/reference/html/ix03.html

docs/reference/html/ix04.html

docs/reference/html/ix05.html

docs/reference/html/ix06.html

docs/reference/html/ix07.html

docs/reference/html/ix08.html

docs/reference/html/ix09.html

docs/reference/html/pt01.html

docs/reference/html/pt02.html

docs/reference/html/pt03.html

docs/reference/html/pt04.html

docs/reference/html/pt05.html

docs/reference/version.xml

gdata/atom/gdata-category.c

gdata/atom/gdata-link.c

gdata/gcontact/gdata-gcontact-calendar.c

gdata/gcontact/gdata-gcontact-event.c

gdata/gcontact/gdata-gcontact-external-id.c

gdata/gcontact/gdata-gcontact-jot.c

gdata/gcontact/gdata-gcontact-language.c

gdata/gcontact/gdata-gcontact-relation.c

gdata/gcontact/gdata-gcontact-website.c

gdata/gdata-access-rule.c

gdata/gdata-batch-feed.c

gdata/gdata-batch-operation.c

gdata/gdata-buffer.c

gdata/gdata-download-stream.c

gdata/gdata-download-stream.h

gdata/gdata-entry.c

gdata/gdata-feed.c

gdata/gdata-private.h

gdata/gdata-service.c

gdata/gdata-upload-stream.c

gdata/gdata-upload-stream.h

gdata/gdata.symbols

gdata/media/gdata-media-category.c

gdata/media/gdata-media-content.c

gdata/media/gdata-media-content.h

gdata/media/gdata-media-group.c

gdata/media/gdata-media-thumbnail.c

gdata/media/gdata-media-thumbnail.h

gdata/services/calendar/gdata-calendar-calendar.c

gdata/services/calendar/gdata-calendar-event.c

gdata/services/calendar/gdata-calendar-query.c

gdata/services/calendar/gdata-calendar-service.c

gdata/services/calendar/gdata-calendar-service.h

gdata/services/contacts/gdata-contacts-contact.c

gdata/services/contacts/gdata-contacts-contact.h

gdata/services/contacts/gdata-contacts-group.c

gdata/services/contacts/gdata-contacts-query.c

gdata/services/contacts/gdata-contacts-service.c

gdata/services/documents/gdata-documents-document.c

gdata/services/documents/gdata-documents-document.h

gdata/services/documents/gdata-documents-entry.c

gdata/services/documents/gdata-documents-folder.c

gdata/services/documents/gdata-documents-presentation.c

gdata/services/documents/gdata-documents-query.c

gdata/services/documents/gdata-documents-service.c

gdata/services/documents/gdata-documents-service.h

gdata/services/documents/gdata-documents-spreadsheet.c

gdata/services/documents/gdata-documents-text.c

gdata/services/picasaweb/gdata-picasaweb-album.c

gdata/services/picasaweb/gdata-picasaweb-file.c

gdata/services/picasaweb/gdata-picasaweb-file.h

gdata/services/picasaweb/gdata-picasaweb-service.c

gdata/services/picasaweb/gdata-picasaweb-service.h

gdata/services/youtube/gdata-youtube-credit.c

gdata/services/youtube/gdata-youtube-service.c

gdata/services/youtube/gdata-youtube-service.h

gdata/services/youtube/gdata-youtube-video.c

gdata/services/youtube/gdata-youtube-video.h

gdata/tests/Makefile.am

gdata/tests/Makefile.in

gdata/tests/calendar.c

gdata/tests/common.c

gdata/tests/common.h

gdata/tests/contacts.c

gdata/tests/documents.c

gdata/tests/general.c

gdata/tests/picasaweb.c

gdata/tests/youtube.c

ltmain.sh

po/LINGUAS

po/POTFILES.in

po/cs.po

po/da.po

po/de.po

po/en_GB.po

po/es.po

po/eu.po

po/fr.po

po/hu.po

po/sl.po

po/sv.po

po/zh_CN.po

Show diffs side-by-side

added added

removed removed

docs/reference/html/GDataDocumentsService.html

</div>

<a name="GDataDocumentsService.synopsis"></a><h2>Synopsis</h2>

#include <gdata/services/documents/gdata-documents-service.h>

<a class="link" href="GDataDocumentsService.html#GDataDocumentsService-struct" title="GDataDocumentsService">GDataDocumentsService</a>;

<a class="link" href="GDataDocumentsService.html#GDataDocumentsServiceClass" title="GDataDocumentsServiceClass">GDataDocumentsServiceClass</a>;

enum <a class="link" href="GDataDocumentsService.html#GDataDocumentsServiceError" title="enum GDataDocumentsServiceError">GDataDocumentsServiceError</a>;

<a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-new" title="gdata_documents_service_new ()">gdata_documents_service_new</a> (<code>const <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *client_id</code>);

enum <a class="link" href="GDataDocumentsService.html#GDataDocumentsServiceError">GDataDocumentsServiceError</a>;

<a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-new" title="gdata_documents_service_new ()">gdata_documents_service_new</a> (<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *client_id</code>);

<a class="link" href="GDataDocumentsFeed.html" title="GDataDocumentsFeed">GDataDocumentsFeed</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-query-documents" title="gdata_documents_service_query_documents ()">gdata_documents_service_query_documents</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> *query</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()">GDataQueryProgressCallback</a> progress_callback</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

void <a class="link" href="GDataDocumentsService.html#gdata-documents-service-query-documents-async" title="gdata_documents_service_query_documents_async ()">gdata_documents_service_query_documents_async</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> *query</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-upload-document" title="gdata_documents_service_upload_document ()">gdata_documents_service_upload_document</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html">GFile</a> *document_file</code>,

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-update-document" title="gdata_documents_service_update_document ()">gdata_documents_service_update_document</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html">GFile</a> *document_file</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-move-document-to-folder" title="gdata_documents_service_move_document_to_folder ()">gdata_documents_service_move_document_to_folder</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-document-from-folder" title="gdata_documents_service_remove_document_from_folder ()">gdata_documents_service_remove_document_from_folder</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-get-upload-uri" title="gdata_documents_service_get_upload_uri ()">gdata_documents_service_get_upload_uri</a>

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

<a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-upload-document" title="gdata_documents_service_upload_document ()">gdata_documents_service_upload_document</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> *document</code>,

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *slug</code>,

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *content_type</code>,

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-update-document" title="gdata_documents_service_update_document ()">gdata_documents_service_update_document</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> *document</code>,

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *slug</code>,

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *content_type</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-finish-upload" title="gdata_documents_service_finish_upload ()">gdata_documents_service_finish_upload</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> *upload_stream</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder" title="gdata_documents_service_add_entry_to_folder ()">gdata_documents_service_add_entry_to_folder</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

void <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder-async" title="gdata_documents_service_add_entry_to_folder_async ()">gdata_documents_service_add_entry_to_folder_async</a>

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

100

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

101

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

102

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

103

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

104

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder-finish" title="gdata_documents_service_add_entry_to_folder_finish ()">gdata_documents_service_add_entry_to_folder_finish</a>

105

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

106

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a> *async_result</code>,

107

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

108

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder" title="gdata_documents_service_remove_entry_from_folder ()">gdata_documents_service_remove_entry_from_folder</a>

109

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

110

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

111

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

112

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

113

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

114

void <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder-async" title="gdata_documents_service_remove_entry_from_folder_async ()">gdata_documents_service_remove_entry_from_folder_async</a>

115

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

116

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

117

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

118

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

119

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

120

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

121

<a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder-finish" title="gdata_documents_service_remove_entry_from_folder_finish ()">gdata_documents_service_remove_entry_from_folder_finish</a>

122

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

123

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a> *async_result</code>,

124

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);

125

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GDataDocumentsService.html#gdata-documents-service-get-upload-uri" title="gdata_documents_service_get_upload_uri ()">gdata_documents_service_get_upload_uri</a>

126

(<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>);

127

</pre>

100

128

</div>

101

129

102

130

<a name="GDataDocumentsService.object-hierarchy"></a><h2>Object Hierarchy</h2>

103

131

104

<a href="/opt/gnome2/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

132

<a href="/opt/gnome3/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

105

133

+----<a class="link" href="GDataService.html" title="GDataService">GDataService</a>

106

134

+----GDataDocumentsService

107

135

</pre>

136

137

GEnum

138

+----GDataDocumentsServiceError

139

</pre>

108

140

</div>

109

141

110

142

<a name="GDataDocumentsService.implemented-interfaces"></a><h2>Implemented Interfaces</h2>

133

165

134

166

online explanation about the problem</a>.

135

167

168

169

170

171

<a name="id665406"></a>Example 21. Uploading a Document from Disk

172

173

174

<tbody>

175

<tr>

176

<td class="listing_lines" align="right"><pre>1

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

95</pre></td>

271

<td class="listing_code"><pre class="programlisting">GDataDocumentsService *service;

272

GDataDocumentsDocument *document, *uploaded_document;

273

GFile *document_file;

274

GDataDocumentsFolder *destination_folder;

275

GFileInfo *file_info;

276

const gchar *slug, *content_type;

277

GFileInputStream *file_stream;

278

GDataUploadStream *upload_stream;

279

GError *error = <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>;

280

281

/* Create a service */

282

service = create_documents_service ();

283

284

/* Get the document file to upload and the folder to upload it into */

285

document_file = <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFile.html#g-file-new-for-path">g_file_new_for_path</a> ("document.odt");

286

destination_folder = query_user_for_destination_folder (service);

287

288

/* Get the file's display name and content type */

289

file_info = <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFile.html#g-file-query-info">g_file_query_info</a> (document_file, <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME:CAPS">G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</a> "," <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-CONTENT-TYPE:CAPS">G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE</a>,

290

<a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFile.html#G-FILE-QUERY-INFO-NONE:CAPS">G_FILE_QUERY_INFO_NONE</a>, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, &error);

291

292

if (error != <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>) {

293

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error getting document file information: %s", error->message);

294

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#g-error-free">g_error_free</a> (error);

295

<a href="/opt/gnome3/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (destination_folder);

296

297

298

return;

299

}

300

301

slug = <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFileInfo.html#g-file-info-get-display-name">g_file_info_get_display_name</a> (file_info);

302

content_type = <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFileInfo.html#g-file-info-get-content-type">g_file_info_get_content_type</a> (file_info);

303

304

/* Get an input stream for the file */

305

file_stream = <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GFile.html#g-file-read">g_file_read</a> (document_file, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, &error);

306

307

<a href="/opt/gnome3/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (document_file);

308

309

310

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error getting document file stream: %s", error->message);

311

312

313

314

315

return;

316

}

317

318

/* Create the document metadata to upload */

319

document = <a href="GDataDocumentsText.html#gdata-documents-text-new">gdata_documents_text_new</a> (<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

320

<a href="GDataEntry.html#gdata-entry-set-title">gdata_entry_set_title</a> (GDATA_ENTRY (document), "Document Title");

321

322

/* Get an upload stream for the document */

323

upload_stream = <a href="GDataDocumentsService.html#gdata-documents-service-upload-document">gdata_documents_service_upload_document</a> (service, document, slug, content_type, destination_folder, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, &error);

324

325

326

327

328

329

330

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error getting upload stream: %s", error->message);

331

332

333

334

return;

335

}

336

337

/* Upload the document. This is a blocking operation, and should normally be done asynchronously. */

338

<a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html#g-output-stream-splice">g_output_stream_splice</a> (G_OUTPUT_STREAM (upload_stream), G_INPUT_STREAM (file_stream),

339

<a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html#G-OUTPUT-STREAM-SPLICE-CLOSE-SOURCE:CAPS">G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE</a> | <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html#G-OUTPUT-STREAM-SPLICE-CLOSE-TARGET:CAPS">G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET</a>, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, &error);

340

341

342

343

344

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error splicing streams: %s", error->message);

345

346

347

348

return;

349

}

350

351

/* Finish off the upload by parsing the returned updated document metadata entry */

352

uploaded_document = <a href="GDataDocumentsService.html#gdata-documents-service-finish-upload">gdata_documents_service_finish_upload</a> (service, upload_stream, &error);

353

354

355

356

357

358

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error uploading document: %s", error->message);

359

360

return;

361

}

362

363

/* Do something with the uploaded document */

364

365

366

</tr>

367

</tbody>

368

</table>

369

</div>

370

371

</div>

372

373

374

375

The Documents service can be manipulated using batch operations, too. See the

376

<a class="ulink" href="http://code.google.com/apis/documents/docs/2.0/developers_guide_protocol.html#ACLBatch" target="_top">online documentation on batch

377

operations</a> for more information.

378

379

380

381

382

<a name="id692889"></a>Example 22. Performing a Batch Operation on Documents

383

384

385

<tbody>

386

<tr>

387

<td class="listing_lines" align="right"><pre>1

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

60</pre></td>

447

448

GDataBatchOperation *operation;

449

GDataFeed *feed;

450

GDataLink *batch_link;

451

GList *i;

452

453

454

/* Create a service */

455

456

457

/* Create the batch operation; this requires that we have done a query first so that we can get the batch link */

458

feed = do_some_query (service);

459

batch_link = <a href="GDataFeed.html#gdata-feed-look-up-link">gdata_feed_look_up_link</a> (feed, <a href="GDataLink.html#GDATA-LINK-BATCH:CAPS">GDATA_LINK_BATCH</a>);

460

operation = <a href="GDataBatchable.html#gdata-batchable-create-operation">gdata_batchable_create_operation</a> (GDATA_BATCHABLE (service), <a href="GDataLink.html#gdata-link-get-uri">gdata_link_get_uri</a> (batch_link));

461

462

463

<a href="GDataBatchOperation.html#gdata-batch-operation-add-query">gdata_batch_operation_add_query</a> (operation, presentation_entry_id_to_query, GDATA_TYPE_DOCUMENTS_PRESENTATION,

464

(<a href="GDataBatchOperation.html#GDataBatchOperationCallback">GDataBatchOperationCallback</a>) batch_query_cb, user_data);

465

<a href="GDataBatchOperation.html#gdata-batch-operation-add-insertion">gdata_batch_operation_add_insertion</a> (operation, new_entry, (<a href="GDataBatchOperation.html#GDataBatchOperationCallback">GDataBatchOperationCallback</a>) batch_insertion_cb, user_data);

466

<a href="GDataBatchOperation.html#gdata-batch-operation-add-update">gdata_batch_operation_add_update</a> (operation, old_entry, (<a href="GDataBatchOperation.html#GDataBatchOperationCallback">GDataBatchOperationCallback</a>) batch_update_cb, user_data);

467

<a href="GDataBatchOperation.html#gdata-batch-operation-add-deletion">gdata_batch_operation_add_deletion</a> (operation, entry_to_delete, (<a href="GDataBatchOperation.html#GDataBatchOperationCallback">GDataBatchOperationCallback</a>) batch_deletion_cb, user_data);

468

469

/* Run the batch operation and handle the results in the various callbacks */

470

gdata_test_batch_operation_run (operation, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a>, &error);

471

472

473

474

475

476

<a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error">g_error</a> ("Error running batch operation: %s", error->message);

477

478

return;

479

}

480

481

static void

482

batch_query_cb (guint operation_id, GDataBatchOperationType operation_type, GDataEntry *entry, GError *error, gpointer user_data)

483

{

484

/* operation_type == GDATA_BATCH_OPERATION_QUERY */

485

/* Reference and do something with the returned entry. */

486

}

487

488

static void

489

batch_insertion_cb (guint operation_id, GDataBatchOperationType operation_type, GDataEntry *entry, GError *error, gpointer user_data)

490

{

491

/* operation_type == GDATA_BATCH_OPERATION_INSERTION */

492

/* Reference and do something with the returned entry. */

493

}

494

495

static void

496

batch_update_cb (guint operation_id, GDataBatchOperationType operation_type, GDataEntry *entry, GError *error, gpointer user_data)

497

{

498

/* operation_type == GDATA_BATCH_OPERATION_UPDATE */

499

/* Reference and do something with the returned entry. */

500

}

501

502

static void

503

batch_deletion_cb (guint operation_id, GDataBatchOperationType operation_type, GDataEntry *entry, GError *error, gpointer user_data)

504

{

505

/* operation_type == GDATA_BATCH_OPERATION_DELETION, entry == NULL */

506

}</pre></td>

507

</tr>

508

</tbody>

509

</table>

510

</div>

511

512

</div>

513

514

136

515

</div>

137

516

138

517

<a name="GDataDocumentsService.details"></a><h2>Details</h2>

178

557

<hr>

179

558

180

559

<a name="gdata-documents-service-new"></a><h3>gdata_documents_service_new ()</h3>

181

<pre class="programlisting"><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> * gdata_documents_service_new (<code>const <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *client_id</code>);</pre>

560

<pre class="programlisting"><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> * gdata_documents_service_new (<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *client_id</code>);</pre>

182

561

183

562

Creates a new <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>. The <code>client_id</code> must be unique for your application, and as registered with Google.

184

563

191

570

</tr>

192

571

<tr>

193

572

<td>Returns :</td>

194

<td>a new <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="/opt/gnome2/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>

573

<td>a new <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</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>

195

574

</td>

196

575

</tr>

197

576

</tbody>

204

583

<pre class="programlisting"><a class="link" href="GDataDocumentsFeed.html" title="GDataDocumentsFeed">GDataDocumentsFeed</a> * gdata_documents_service_query_documents

205

584

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

206

585

<code><a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> *query</code>,

207

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

586

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

208

587

209

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

210

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

588

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

589

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

211

590

212

591

Queries the service to return a list of documents matching the given <code>query</code>. Note that <code>query</code> has to be a <a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a>, rather than just

213

592

a <a class="link" href="GDataQuery.html" title="GDataQuery">GDataQuery</a>, as it uses the folder ID specified in <a class="link" href="GDataDocumentsQuery.html#GDataDocumentsQuery--folder-id" title='The "folder-id" property'>"folder-id"</a>.

225

604

</tr>

226

605

<tr>

227

606

<td><code>query</code> :</td>

228

<td>a <a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> with the query parameters, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

607

<td>a <a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> with the query parameters, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

229

608

</td>

230

609

</tr>

231

610

<tr>

232

611

<td><code>cancellable</code> :</td>

233

<td>optional <a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> object, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

612

<td>optional <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</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>

234

613

</td>

235

614

</tr>

236

615

<tr>

237

616

<td><code>progress_callback</code> :</td>

238

<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()">GDataQueryProgressCallback</a> to call when an entry is loaded, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

617

<td>a <a class="link" href="GDataService.html#GDataQueryProgressCallback" title="GDataQueryProgressCallback ()">GDataQueryProgressCallback</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>. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

239

618

</td>

240

619

</tr>

241

620

<tr>

245

624

</tr>

246

625

<tr>

247

626

<td><code>error</code> :</td>

248

<td>a <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

627

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

249

628

</td>

250

629

</tr>

251

630

<tr>

252

631

<td>Returns :</td>

253

<td>a <a class="link" href="GDataDocumentsFeed.html" title="GDataDocumentsFeed">GDataDocumentsFeed</a> of query results; unref with <a href="/opt/gnome2/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

632

<td>a <a class="link" href="GDataDocumentsFeed.html" title="GDataDocumentsFeed">GDataDocumentsFeed</a> of query results; 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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

254

633

</td>

255

634

</tr>

256

635

</tbody>

263

642

<pre class="programlisting">void gdata_documents_service_query_documents_async

264

643

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

265

644

<code><a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> *query</code>,

266

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

645

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

267

646

268

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

269

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

270

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

647

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_user_data</code>,

648

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

649

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

271

650

272

651

Queries the service to return a list of documents matching the given <code>query</code>. <code>self</code> and

273

652

<code>query</code> are both reffed when this function is called, so can safely be unreffed after this function returns.

286

665

</tr>

287

666

<tr>

288

667

<td><code>query</code> :</td>

289

668

<td>a <a class="link" href="GDataDocumentsQuery.html" title="GDataDocumentsQuery">GDataDocumentsQuery</a> with the query parameters, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

290

669

</td>

291

670

</tr>

292

671

<tr>

293

672

<td><code>cancellable</code> :</td>

294

673

295

674

</td>

296

675

</tr>

297

676

<tr>

298

677

<td><code>progress_callback</code> :</td>

299

678

300

679

</td>

301

680

</tr>

302

681

<tr>

305

684

</tr>

306

685

<tr>

307

686

<td><code>callback</code> :</td>

308

<td>a <a href="/opt/gnome2/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> to call when authentication is finished</td>

687

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> to call when authentication is finished</td>

309

688

</tr>

310

689

<tr>

311

690

319

698

<hr>

320

699

321

700

<a name="gdata-documents-service-upload-document"></a><h3>gdata_documents_service_upload_document ()</h3>

322

<pre class="programlisting"><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> * gdata_documents_service_upload_document

701

<pre class="programlisting"><a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> * gdata_documents_service_upload_document

323

702

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

324

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

325

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html">GFile</a> *document_file</code>,

703

<code><a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> *document</code>,

704

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *slug</code>,

705

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *content_type</code>,

326

706

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

327

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

328

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

329

330

Uploads a document to Google Documents, using the properties from <code>document</code> and the document file pointed to by <code>document_file</code>.

331

332

333

If <code>document</code> is <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, only the document file will be uploaded. The new document entry will be named after the document file's name,

334

and will have default metadata.

335

336

337

If <code>document_file</code> is <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, only the document metadata will be uploaded. A blank document file will be created with the name

338

<code class="literal">new document</code> and the specified metadata. <code>document</code> and <code>document_file</code> cannot both be <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but can both have values.

339

340

341

The updated <code>document_entry</code> will be returned on success, containing updated metadata.

342

343

344

If there is a problem reading <code>document_file</code>, an error from <a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html#g-file-load-contents"><code class="function">g_file_load_contents()</code></a> or <a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html#g-file-query-info"><code class="function">g_file_query_info()</code></a> will be returned. Other errors from

345

<a class="link" href="GDataService.html#GDataServiceError" title="enum GDataServiceError">GDataServiceError</a> can be returned for other exceptional conditions, as determined by the server.

707

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

708

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

709

710

Uploads a document to Google Documents, using the properties from <code>document</code> and the document data written to the resulting <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a>. If

711

the document data does not need to be provided at the moment, just the metadata, use <a class="link" href="GDataService.html#gdata-service-insert-entry" title="gdata_service_insert_entry ()"><code class="function">gdata_service_insert_entry()</code></a> instead (e.g. in the case of

712

creating a new, empty file to be edited at a later date).

713

714

715

If <code>document</code> is <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, only the document data will be uploaded. The new document entry will be named using <code>slug</code>, and will have default metadata.

716

717

718

The stream returned by this function should be written to using the standard <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html">GOutputStream</a> methods, asychronously or synchronously. Once the stream

719

is closed (using <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html#g-output-stream-close"><code class="function">g_output_stream_close()</code></a>), <a class="link" href="GDataDocumentsService.html#gdata-documents-service-finish-upload" title="gdata_documents_service_finish_upload ()"><code class="function">gdata_documents_service_finish_upload()</code></a> should be called on it to parse and return the updated

720

<a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> for the document. This must be done, as <code>document</code> isn't updated in-place.

721

722

723

In order to cancel the upload, a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> passed in to <code>cancellable</code> must be cancelled using <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html#g-cancellable-cancel"><code class="function">g_cancellable_cancel()</code></a>. Cancelling the individual

724

<a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html">GOutputStream</a> operations on the <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> will not cancel the entire upload; merely the write or close operation in question. See the

725

<a class="link" href="GDataUploadStream.html#GDataUploadStream--cancellable" title='The "cancellable" property'>"cancellable"</a> for more details.

726

727

728

Any upload errors will be thrown by the stream methods, and may come from the <a class="link" href="GDataService.html#GDataServiceError" title="enum GDataServiceError">GDataServiceError</a> domain.

346

729

347

730

348

731

354

737

</tr>

355

738

<tr>

356

739

<td><code>document</code> :</td>

357

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to insert, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

358

</td>

359

</tr>

360

<tr>

361

<td><code>document_file</code> :</td>

362

<td>the document to upload, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

363

</td>

740

<td>the <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> to insert, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

741

</td>

742

</tr>

743

<tr>

744

745

<td>the filename to give to the uploaded document</td>

746

</tr>

747

<tr>

748

<td><code>content_type</code> :</td>

749

<td>the content type of the uploaded data</td>

364

750

</tr>

365

751

<tr>

366

752

<td><code>folder</code> :</td>

367

<td>the folder to which the document should be uploaded, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

753

<td>the folder to which the document should be uploaded, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

368

754

</td>

369

755

</tr>

370

756

<tr>

371

757

<td><code>cancellable</code> :</td>

372

758

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> for the entire upload stream, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

373

759

</td>

374

760

</tr>

375

761

<tr>

376

762

<td><code>error</code> :</td>

377

763

378

764

</td>

379

765

</tr>

380

766

<tr>

381

767

<td>Returns :</td>

382

<td>an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a>, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="/opt/gnome2/build/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

768

<td>a <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> to write the document data to, 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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

383

769

</td>

384

770

</tr>

385

771

</tbody>

386

772

</table></div>

387

Since 0.4.0

773

Since 0.8.0

388

774

</div>

389

775

<hr>

390

776

391

777

<a name="gdata-documents-service-update-document"></a><h3>gdata_documents_service_update_document ()</h3>

392

778

<pre class="programlisting"><a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> * gdata_documents_service_update_document

393

779

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

394

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

395

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GFile.html">GFile</a> *document_file</code>,

396

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

397

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

398

399

Update the document using the properties from <code>document</code> and the document file pointed to by <code>document_file</code>. If the document file does not

400

need to be changed, <code>document_file</code> can be <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

401

402

403

404

405

406

407

For more details, see <a class="link" href="GDataService.html#gdata-service-insert-entry" title="gdata_service_insert_entry ()"><code class="function">gdata_service_insert_entry()</code></a>.

780

<code><a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> *document</code>,

781

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *slug</code>,

782

<code>const <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *content_type</code>,

783

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

784

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

785

786

Update the document using the properties from <code>document</code> and the document data written to the resulting <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a>. If the document data does

787

not need to be changed, just the metadata, use <a class="link" href="GDataService.html#gdata-service-update-entry" title="gdata_service_update_entry ()"><code class="function">gdata_service_update_entry()</code></a> instead.

788

789

790

791

792

793

794

795

In order to cancel the update, a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> passed in to <code>cancellable</code> must be cancelled using <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html#g-cancellable-cancel"><code class="function">g_cancellable_cancel()</code></a>. Cancelling the individual

796

<a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html">GOutputStream</a> operations on the <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> will not cancel the entire update; merely the write or close operation in question. See the

797

<a class="link" href="GDataUploadStream.html#GDataUploadStream--cancellable" title='The "cancellable" property'>"cancellable"</a> for more details.

798

799

800

801

802

803

For more information, see <a class="link" href="GDataService.html#gdata-service-update-entry" title="gdata_service_update_entry ()"><code class="function">gdata_service_update_entry()</code></a>.

408

804

409

805

410

806

416

812

</tr>

417

813

<tr>

418

814

<td><code>document</code> :</td>

419

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to update</td>

420

</tr>

421

<tr>

422

<td><code>document_file</code> :</td>

423

<td>the local document file containing the new data, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

424

</td>

815

<td>the <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> to update</td>

816

</tr>

817

<tr>

818

819

<td>the filename to give to the uploaded document</td>

820

</tr>

821

<tr>

822

<td><code>content_type</code> :</td>

823

<td>the content type of the uploaded data</td>

425

824

</tr>

426

825

<tr>

427

826

<td><code>cancellable</code> :</td>

428

429

</td>

430

</tr>

431

<tr>

432

<td><code>error</code> :</td>

433

434

</td>

435

</tr>

436

<tr>

437

<td>Returns :</td>

438

439

</td>

440

</tr>

441

</tbody>

442

</table></div>

443

Since 0.4.0

444

</div>

445

<hr>

446

447

<a name="gdata-documents-service-move-document-to-folder"></a><h3>gdata_documents_service_move_document_to_folder ()</h3>

448

449

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

450

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

827

828

</td>

829

</tr>

830

<tr>

831

<td><code>error</code> :</td>

832

833

</td>

834

</tr>

835

<tr>

836

<td>Returns :</td>

837

<td>a <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> to write the document data to; 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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

838

</td>

839

</tr>

840

</tbody>

841

</table></div>

842

Since 0.8.0

843

</div>

844

<hr>

845

846

<a name="gdata-documents-service-finish-upload"></a><h3>gdata_documents_service_finish_upload ()</h3>

847

<pre class="programlisting"><a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> * gdata_documents_service_finish_upload

848

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

849

<code><a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> *upload_stream</code>,

850

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

851

852

Finish off a document upload or update operation started by <a class="link" href="GDataDocumentsService.html#gdata-documents-service-upload-document" title="gdata_documents_service_upload_document ()"><code class="function">gdata_documents_service_upload_document()</code></a> or <a class="link" href="GDataDocumentsService.html#gdata-documents-service-update-document" title="gdata_documents_service_update_document ()"><code class="function">gdata_documents_service_update_document()</code></a>,

853

parsing the result and returning the new or updated <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a>.

854

855

856

If an error occurred during the upload or update operation, it will have been returned during the operation (e.g. by <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GOutputStream.html#g-output-stream-splice"><code class="function">g_output_stream_splice()</code></a> or one

857

of the other stream methods). In such a case, <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned but <code>error</code> will remain unset. <code>error</code> is only set in the case that the server

858

indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.

859

860

861

In the case that no <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> was passed (to <a class="link" href="GDataDocumentsService.html#gdata-documents-service-upload-document" title="gdata_documents_service_upload_document ()"><code class="function">gdata_documents_service_upload_document()</code></a> or <a class="link" href="GDataDocumentsService.html#gdata-documents-service-update-document" title="gdata_documents_service_update_document ()"><code class="function">gdata_documents_service_update_document()</code></a>)

862

when starting the operation, <a class="link" href="GDataDocumentsService.html#GDATA-DOCUMENTS-SERVICE-ERROR-INVALID-CONTENT-TYPE:CAPS"><code class="literal">GDATA_DOCUMENTS_SERVICE_ERROR_INVALID_CONTENT_TYPE</code></a> will be thrown in <code>error</code> if the content type of the uploaded data

863

could not be mapped to a document type with which to interpret the response from the server.

864

865

866

867

<tbody>

868

<tr>

869

870

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

871

</td>

872

</tr>

873

<tr>

874

<td><code>upload_stream</code> :</td>

875

<td>the <a class="link" href="GDataUploadStream.html" title="GDataUploadStream">GDataUploadStream</a> from the operation</td>

876

</tr>

877

<tr>

878

<td><code>error</code> :</td>

879

880

</td>

881

</tr>

882

<tr>

883

<td>Returns :</td>

884

<td>the new or updated <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

885

</td>

886

</tr>

887

</tbody>

888

</table></div>

889

Since 0.8.0

890

</div>

891

<hr>

892

893

<a name="gdata-documents-service-add-entry-to-folder"></a><h3>gdata_documents_service_add_entry_to_folder ()</h3>

894

895

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

896

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

451

897

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

452

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

453

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

898

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

899

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

454

900

455

Move the given <code>document</code> to the specified <code>folder</code>. If the document is already in another folder, it will be added to

456

the new folder, but will also remain in any previous folders.

901

Add the given <code>entry</code> to the specified <code>folder</code>, and return an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> for <code>entry</code>. If the <code>entry</code> is already in another folder, it

902

will be added to the new folder, but will also remain in its other folders. Note that <code>entry</code> can be either a <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> or a

903

<a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a>.

457

904

458

905

459

Errors from <a class="link" href="GDataService.html#GDataServiceError" title="enum GDataServiceError">GDataServiceError</a> can be returned for other exceptional conditions, as determined by the server.

906

Errors from <a class="link" href="GDataService.html#GDataServiceError" title="enum GDataServiceError">GDataServiceError</a> can be returned for exceptional conditions, as determined by the server.

460

907

461

908

462

909

467

914

</td>

468

915

</tr>

469

916

<tr>

470

<td><code>document</code> :</td>

917

<td><code>entry</code> :</td>

471

918

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to move</td>

472

919

</tr>

473

920

<tr>

474

921

<td><code>folder</code> :</td>

475

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> to move <code>document</code> into</td>

476

</tr>

477

<tr>

478

<td><code>cancellable</code> :</td>

479

480

</td>

481

</tr>

482

<tr>

483

<td><code>error</code> :</td>

484

485

</td>

486

</tr>

487

<tr>

488

<td>Returns :</td>

489

490

</td>

491

</tr>

492

</tbody>

493

</table></div>

494

Since 0.4.0

495

</div>

496

<hr>

497

498

<a name="gdata-documents-service-remove-document-from-folder"></a><h3>gdata_documents_service_remove_document_from_folder ()</h3>

499

500

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

501

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *document</code>,

502

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

503

<code><a href="/opt/gnome2/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

504

<code><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

505

506

Remove the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> <code>document</code> from the GDataDocumentsFolder <code>folder</code>, and updates the document entry <code>document</code>.

507

508

509

510

511

512

513

<tbody>

514

<tr>

515

516

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

517

</td>

518

</tr>

519

<tr>

520

<td><code>document</code> :</td>

922

923

</tr>

924

<tr>

925

<td><code>cancellable</code> :</td>

926

927

</td>

928

</tr>

929

<tr>

930

<td><code>error</code> :</td>

931

932

</td>

933

</tr>

934

<tr>

935

<td>Returns :</td>

936

<td>an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

937

</td>

938

</tr>

939

</tbody>

940

</table></div>

941

Since 0.8.0

942

</div>

943

<hr>

944

945

<a name="gdata-documents-service-add-entry-to-folder-async"></a><h3>gdata_documents_service_add_entry_to_folder_async ()</h3>

946

<pre class="programlisting">void gdata_documents_service_add_entry_to_folder_async

947

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

948

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

949

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

950

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

951

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

952

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

953

954

Add the given <code>entry</code> to the specified <code>folder</code>. <code>self</code>, <code>entry</code> and <code>folder</code> are all reffed when this function is called, so can safely be unreffed

955

after this function returns.

956

957

958

For more details, see <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder" title="gdata_documents_service_add_entry_to_folder ()"><code class="function">gdata_documents_service_add_entry_to_folder()</code></a>, which is the synchronous version of this function.

959

960

961

When the operation is finished, <code>callback</code> will be called. You can then call <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder-finish" title="gdata_documents_service_add_entry_to_folder_finish ()"><code class="function">gdata_documents_service_add_entry_to_folder_finish()</code></a> to get the results

962

of the operation.

963

964

965

966

<tbody>

967

<tr>

968

969

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

970

</td>

971

</tr>

972

<tr>

973

<td><code>entry</code> :</td>

974

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to add to <code>folder</code>

975

</td>

976

</tr>

977

<tr>

978

<td><code>folder</code> :</td>

979

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> to add <code>entry</code> to</td>

980

</tr>

981

<tr>

982

<td><code>cancellable</code> :</td>

983

984

</td>

985

</tr>

986

<tr>

987

<td><code>callback</code> :</td>

988

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> to call when the operation is finished, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

989

</td>

990

</tr>

991

<tr>

992

993

<td>data to pass to the <code>callback</code> function. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

994

</td>

995

</tr>

996

</tbody>

997

</table></div>

998

Since 0.8.0

999

</div>

1000

<hr>

1001

1002

<a name="gdata-documents-service-add-entry-to-folder-finish"></a><h3>gdata_documents_service_add_entry_to_folder_finish ()</h3>

1003

1004

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

1005

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a> *async_result</code>,

1006

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1007

1008

Finish an asynchronous operation to add a <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to a folder started with <a class="link" href="GDataDocumentsService.html#gdata-documents-service-add-entry-to-folder-async" title="gdata_documents_service_add_entry_to_folder_async ()"><code class="function">gdata_documents_service_add_entry_to_folder_async()</code></a>.

1009

1010

1011

1012

<tbody>

1013

<tr>

1014

1015

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

1016

</td>

1017

</tr>

1018

<tr>

1019

<td><code>async_result</code> :</td>

1020

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a>

1021

</td>

1022

</tr>

1023

<tr>

1024

<td><code>error</code> :</td>

1025

1026

</td>

1027

</tr>

1028

<tr>

1029

<td>Returns :</td>

1030

<td>an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

1031

</td>

1032

</tr>

1033

</tbody>

1034

</table></div>

1035

Since 0.8.0

1036

</div>

1037

<hr>

1038

1039

<a name="gdata-documents-service-remove-entry-from-folder"></a><h3>gdata_documents_service_remove_entry_from_folder ()</h3>

1040

1041

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

1042

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

1043

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

1044

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

1045

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1046

1047

Remove the given <code>entry</code> from <code>folder</code>, and return an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> for <code>entry</code>. <code>entry</code> will remain a member of any other folders it's

1048

currently in. Note that <code>entry</code> can be either a <a class="link" href="GDataDocumentsDocument.html" title="GDataDocumentsDocument">GDataDocumentsDocument</a> or a <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a>.

1049

1050

1051

Errors from <a class="link" href="GDataService.html#GDataServiceError" title="enum GDataServiceError">GDataServiceError</a> can be returned for exceptional conditions, as determined by the server.

1052

1053

1054

1055

<tbody>

1056

<tr>

1057

1058

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

1059

</td>

1060

</tr>

1061

<tr>

1062

<td><code>entry</code> :</td>

521

1063

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to remove</td>

522

1064

</tr>

523

1065

<tr>

524

1066

<td><code>folder</code> :</td>

525

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> from which we should remove <code>document</code>

526

</td>

527

</tr>

528

<tr>

529

<td><code>cancellable</code> :</td>

530

531

</td>

532

</tr>

533

<tr>

534

<td><code>error</code> :</td>

535

536

</td>

537

</tr>

538

<tr>

539

<td>Returns :</td>

540

541

</td>

542

</tr>

543

</tbody>

544

</table></div>

545

Since 0.4.0

1067

1068

</td>

1069

</tr>

1070

<tr>

1071

<td><code>cancellable</code> :</td>

1072

1073

</td>

1074

</tr>

1075

<tr>

1076

<td><code>error</code> :</td>

1077

1078

</td>

1079

</tr>

1080

<tr>

1081

<td>Returns :</td>

1082

<td>an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

1083

</td>

1084

</tr>

1085

</tbody>

1086

</table></div>

1087

Since 0.8.0

1088

</div>

1089

<hr>

1090

1091

<a name="gdata-documents-service-remove-entry-from-folder-async"></a><h3>gdata_documents_service_remove_entry_from_folder_async ()</h3>

1092

<pre class="programlisting">void gdata_documents_service_remove_entry_from_folder_async

1093

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

1094

<code><a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> *entry</code>,

1095

<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>,

1096

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GCancellable.html">GCancellable</a> *cancellable</code>,

1097

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback</code>,

1098

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1099

1100

Remove the given <code>entry</code> from the specified <code>folder</code>. <code>self</code>, <code>entry</code> and <code>folder</code> are all reffed when this function is called, so can safely be unreffed

1101

after this function returns.

1102

1103

1104

For more details, see <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder" title="gdata_documents_service_remove_entry_from_folder ()"><code class="function">gdata_documents_service_remove_entry_from_folder()</code></a>, which is the synchronous version of this function.

1105

1106

1107

When the operation is finished, <code>callback</code> will be called. You can then call <a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder-finish" title="gdata_documents_service_remove_entry_from_folder_finish ()"><code class="function">gdata_documents_service_remove_entry_from_folder_finish()</code></a> to get the

1108

results of the operation.

1109

1110

1111

1112

<tbody>

1113

<tr>

1114

1115

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

1116

</td>

1117

</tr>

1118

<tr>

1119

<td><code>entry</code> :</td>

1120

<td>the <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> to remove from <code>folder</code>

1121

</td>

1122

</tr>

1123

<tr>

1124

<td><code>folder</code> :</td>

1125

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> to remove <code>entry</code> from</td>

1126

</tr>

1127

<tr>

1128

<td><code>cancellable</code> :</td>

1129

1130

</td>

1131

</tr>

1132

<tr>

1133

<td><code>callback</code> :</td>

1134

1135

</td>

1136

</tr>

1137

<tr>

1138

1139

1140

</td>

1141

</tr>

1142

</tbody>

1143

</table></div>

1144

Since 0.8.0

1145

</div>

1146

<hr>

1147

1148

<a name="gdata-documents-service-remove-entry-from-folder-finish"></a><h3>gdata_documents_service_remove_entry_from_folder_finish ()</h3>

1149

1150

(<code><a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a> *self</code>,

1151

<code><a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a> *async_result</code>,

1152

<code><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1153

1154

Finish an asynchronous operation to remove a <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</a> from a folder started with

1155

<a class="link" href="GDataDocumentsService.html#gdata-documents-service-remove-entry-from-folder-async" title="gdata_documents_service_remove_entry_from_folder_async ()"><code class="function">gdata_documents_service_remove_entry_from_folder_async()</code></a>.

1156

1157

1158

1159

<tbody>

1160

<tr>

1161

1162

<td>a <a class="link" href="GDataDocumentsService.html" title="GDataDocumentsService">GDataDocumentsService</a>

1163

</td>

1164

</tr>

1165

<tr>

1166

<td><code>async_result</code> :</td>

1167

<td>a <a href="/opt/gnome3/build/share/gtk-doc/html/gio/GAsyncResult.html">GAsyncResult</a>

1168

</td>

1169

</tr>

1170

<tr>

1171

<td><code>error</code> :</td>

1172

1173

</td>

1174

</tr>

1175

<tr>

1176

<td>Returns :</td>

1177

<td>an updated <a class="link" href="GDataDocumentsEntry.html" title="GDataDocumentsEntry">GDataDocumentsEntry</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>. [<acronym title="Free data after the code is done.">transfer full</acronym>]

1178

</td>

1179

</tr>

1180

</tbody>

1181

</table></div>

1182

Since 0.8.0

546

1183

</div>

547

1184

<hr>

548

1185

549

1186

<a name="gdata-documents-service-get-upload-uri"></a><h3>gdata_documents_service_get_upload_uri ()</h3>

550

<pre class="programlisting"><a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> * gdata_documents_service_get_upload_uri

1187

<pre class="programlisting"><a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> * gdata_documents_service_get_upload_uri

551

1188

(<code><a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> *folder</code>);</pre>

552

1189

553

1190

Gets the upload URI for documents for the service.

554

1191

555

1192

556

If <code>folder</code> is <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the URI will be the one to upload documents to the "root" folder.

1193

If <code>folder</code> is <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the URI will be the one to upload documents to the "root" folder.

557

1194

558

1195

559

1196

560

1197

<tbody>

561

1198

<tr>

562

1199

<td><code>folder</code> :</td>

563

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> into which to upload the document, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1200

<td>the <a class="link" href="GDataDocumentsFolder.html" title="GDataDocumentsFolder">GDataDocumentsFolder</a> into which to upload the document, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

564

1201

</td>

565

1202

</tr>

566

1203

<tr>

567

1204

<td>Returns :</td>

568

<td>the URI permitting the upload of documents to <code>folder</code>, or <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="/opt/gnome2/build/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1205

<td>the URI permitting the upload of documents to <code>folder</code>, or <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="/opt/gnome3/build/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

569

1206

</td>

570

1207

</tr>

571

1208

</tbody>

Older »