gdata_entry_new ()

GDataEntry *
gdata_entry_new (const gchar *id);

Creates a new GDataEntry with the given ID and default properties.

gdata_entry_get_title ()

const gchar *
gdata_entry_get_title (GDataEntry *self);

Returns the title of the entry. This will never be NULL, but may be an empty string.

gdata_entry_set_title ()

void
gdata_entry_set_title (GDataEntry *self,
                       const gchar *title);

Sets the title of the entry.

gdata_entry_get_summary ()

const gchar *
gdata_entry_get_summary (GDataEntry *self);

Returns the summary of the entry.

Since: 0.4.0

gdata_entry_set_summary ()

void
gdata_entry_set_summary (GDataEntry *self,
                         const gchar *summary);

Sets the summary of the entry.

Since: 0.4.0

gdata_entry_get_id ()

const gchar *
gdata_entry_get_id (GDataEntry *self);

Returns the URN ID of the entry; a unique and permanent identifier for the object the entry represents.

The ID may be NULL if and only if the GDataEntry has been newly created, and hasn't yet been inserted on the server.

gdata_entry_get_etag ()

const gchar *
gdata_entry_get_etag (GDataEntry *self);

Returns the ETag of the entry; a unique identifier for each version of the entry. For more information, see the

The ETag will never be empty; it's either NULL or a valid ETag.

Since: 0.2.0

gdata_entry_get_content ()

const gchar *
gdata_entry_get_content (GDataEntry *self);

Returns the textual content in this entry. If the content in this entry is pointed to by a URI, NULL will be returned; the content URI will be returned by gdata_entry_get_content_uri().

gdata_entry_set_content ()

void
gdata_entry_set_content (GDataEntry *self,
                         const gchar *content);

Sets the entry's content to content . This unsets “content-uri”.

gdata_entry_get_content_uri ()

const gchar *
gdata_entry_get_content_uri (GDataEntry *self);

Returns a URI pointing to the content of this entry. If the content in this entry is stored directly, NULL will be returned; the content will be returned by gdata_entry_get_content().

Since: 0.7.0

gdata_entry_set_content_uri ()

void
gdata_entry_set_content_uri (GDataEntry *self,
                             const gchar *content_uri);

Sets the URI pointing to the entry's content to content . This unsets “content”.

Since: 0.7.0

gdata_entry_get_published ()

gint64
gdata_entry_get_published (GDataEntry *self);

Gets the time the entry was originally published.

gdata_entry_get_updated ()

gint64
gdata_entry_get_updated (GDataEntry *self);

Gets the time the entry was last updated.

gdata_entry_get_authors ()

GList *
gdata_entry_get_authors (GDataEntry *self);

Gets a list of the GDataAuthors for this entry.

Since: 0.7.0

gdata_entry_add_author ()

void
gdata_entry_add_author (GDataEntry *self,
                        GDataAuthor *author);

Adds author to the list of authors in the given GDataEntry and increments its reference count.

Duplicate authors will not be added to the list.

gdata_entry_add_category ()

void
gdata_entry_add_category (GDataEntry *self,
                          GDataCategory *category);

Adds category to the list of categories in the given GDataEntry, and increments its reference count.

Duplicate categories will not be added to the list.

gdata_entry_get_categories ()

GList *
gdata_entry_get_categories (GDataEntry *self);

Gets a list of the GDataCategorys containing this entry.

Since: 0.2.0

gdata_entry_add_link ()

void
gdata_entry_add_link (GDataEntry *self,
                      GDataLink *_link);

Adds _link to the list of links in the given GDataEntry and increments its reference count.

Duplicate links will not be added to the list.

gdata_entry_remove_link ()

gboolean
gdata_entry_remove_link (GDataEntry *self,
                         GDataLink *_link);

Removes _link from the list of links in the given GDataEntry and decrements its reference count (since the GDataEntry held a reference to it while it was in the list).

Since: 0.10.0

gdata_entry_look_up_link ()

GDataLink *
gdata_entry_look_up_link (GDataEntry *self,
                          const gchar *rel);

Looks up a link by relation type from the list of links in the entry. If the link has one of the standard Atom relation types, use one of the defined rel values, instead of a static string. e.g. GDATA_LINK_EDIT or GDATA_LINK_SELF.

In the rare event of requiring a list of links with the same rel value, use gdata_entry_look_up_links().

Since: 0.1.1

gdata_entry_look_up_links ()

GList *
gdata_entry_look_up_links (GDataEntry *self,
                           const gchar *rel);

Looks up a list of links by relation type from the list of links in the entry. If the links have one of the standard Atom relation types, use one of the defined rel values, instead of a static string. e.g. GDATA_LINK_EDIT or GDATA_LINK_SELF.

If you will only use the first link found, consider calling gdata_entry_look_up_link() instead.

Since: 0.4.0

gdata_entry_is_inserted ()

gboolean
gdata_entry_is_inserted (GDataEntry *self);

Returns whether the entry is marked as having been inserted on (uploaded to) the server already.

gdata_entry_get_rights ()

const gchar *
gdata_entry_get_rights (GDataEntry *self);

Returns the rights pertaining to the entry, or NULL if not set.

Since: 0.5.0

gdata_entry_set_rights ()

void
gdata_entry_set_rights (GDataEntry *self,
                        const gchar *rights);

Sets the rights for this entry.

Since: 0.5.0

GDataEntry

typedef struct _GDataEntry GDataEntry;

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

GDataEntryClass

typedef struct {
	GDataParsableClass parent;

	gchar *(*get_entry_uri) (const gchar *id); /* G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC */
	const gchar *kind_term;
} GDataEntryClass;

The class structure for the GDataEntry type.

The “content” property

  “content”                  gchar *

The content of the entry. This is mutually exclusive with “content”.

For more information, see the Atom specification.

Flags: Read / Write

Default value: NULL

The “content-uri” property

  “content-uri”              gchar *

A URI pointing to the location of the content of the entry. This is mutually exclusive with “content”.

For more information, see the

Flags: Read / Write

Default value: NULL

Since: 0.7.0

The “etag” property

  “etag”                     gchar *

An identifier for a particular version of the entry. This changes every time the entry on the server changes, and can be used for conditional retrieval and locking.

For more information, see the GData specification.

Flags: Read / Write / Construct Only

Default value: NULL

Since: 0.2.0

The “id” property

  “id”                       gchar *

A permanent, universally unique identifier for the entry, in IRI form. This is NULL for new entries (i.e. ones which haven't yet been inserted on the server, created with gdata_entry_new()), and a non-empty IRI string for all other entries.

For more information, see the Atom specification.

Flags: Read / Write / Construct Only

Default value: NULL

The “is-inserted” property

  “is-inserted”              gboolean

Whether the entry has been inserted on the server. This is FALSE for entries which have just been created using gdata_entry_new() and TRUE for entries returned from the server by queries. It is set to TRUE when an entry is inserted using gdata_service_insert_entry().

Flags: Read

Default value: FALSE

The “published” property

  “published”                gint64

The date and time the entry was first published or made available.

For more information, see the Atom specification.

Flags: Read

Allowed values: >= -1

Default value: -1

The “rights” property

  “rights”                   gchar *

The ownership rights pertaining to the entry.

For more information, see the Atom specification.

Flags: Read / Write

Default value: NULL

Since: 0.5.0

The “summary” property

  “summary”                  gchar *

A short summary, abstract, or excerpt of the entry.

For more information, see the Atom specification.

Flags: Read / Write

Default value: NULL

Since: 0.4.0

The “title” property

  “title”                    gchar *

A human-readable title for the entry.

For more information, see the Atom specification.

Flags: Read / Write

Default value: NULL

The “updated” property

  “updated”                  gint64

The date and time when the entry was most recently updated significantly.

For more information, see the Atom specification.

Flags: Read

Allowed values: >= -1

Default value: -1