GData Reference Manual: GDataFeed

## GDataFeed GDataFeed — GData feed object |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <gdata/gdata-feed.h>

                        GDataFeed;
                        GDataFeedClass;
    const gchar *       gdata_feed_get_title                (GDataFeed *self);
    const gchar *       gdata_feed_get_subtitle             (GDataFeed *self);
    const gchar *       gdata_feed_get_id                   (GDataFeed *self);
    const gchar *       gdata_feed_get_etag                 (GDataFeed *self);
    GList *             gdata_feed_get_authors              (GDataFeed *self);
    GList *             gdata_feed_get_categories           (GDataFeed *self);
    GList *             gdata_feed_get_entries              (GDataFeed *self);
    GDataEntry *        gdata_feed_look_up_entry            (GDataFeed *self,
                                                             const gchar *id);
    GDataGenerator *    gdata_feed_get_generator            (GDataFeed *self);
    GList *             gdata_feed_get_links                (GDataFeed *self);
    GDataLink *         gdata_feed_look_up_link             (GDataFeed *self,
                                                             const gchar *rel);
    const gchar *       gdata_feed_get_logo                 (GDataFeed *self);
    const gchar *       gdata_feed_get_icon                 (GDataFeed *self);
    gint64              gdata_feed_get_updated              (GDataFeed *self);
    const gchar *       gdata_feed_get_rights               (GDataFeed *self);
    guint               gdata_feed_get_start_index          (GDataFeed *self);
    guint               gdata_feed_get_total_results        (GDataFeed *self);
    guint               gdata_feed_get_items_per_page       (GDataFeed *self);

## Object Hierarchy

      GObject
       +----GDataParsable
             +----GDataFeed
                   +----GDataCalendarFeed
                   +----GDataDocumentsFeed
                   +----GDataPicasaWebFeed

## Properties

      "etag"                     gchar*                : Read
      "generator"                GDataGenerator*       : Read
      "icon"                     gchar*                : Read
      "id"                       gchar*                : Read
      "items-per-page"           guint                 : Read
      "logo"                     gchar*                : Read
      "rights"                   gchar*                : Read
      "start-index"              guint                 : Read
      "subtitle"                 gchar*                : Read
      "title"                    gchar*                : Read
      "total-results"            guint                 : Read
      "updated"                  gint64                : Read

## Description

GDataFeed is a list of entries (GDataEntry) returned as the result of a query to a GDataService, or given as the input to another operation on the online service. It also has pieces of data associated with the query on the GDataService, such as the query title or timestamp when it was last updated.

Each GDataEntry represents a single object on the online service, such as a playlist, video or calendar entry, and the GDataFeed represents a collection of similar objects.

## Details

### GDataFeed

    typedef struct _GDataFeed GDataFeed;

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

### GDataFeedClass

    typedef struct {
    } GDataFeedClass;

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

### gdata_feed_get_title ()

    const gchar *       gdata_feed_get_title                (GDataFeed *self);

Returns the title of the feed.

`self` : | a GDataFeed
Returns : | the feed's title

### gdata_feed_get_subtitle ()

    const gchar *       gdata_feed_get_subtitle             (GDataFeed *self);

Returns the subtitle of the feed.

`self` : | a GDataFeed
Returns : | the feed's subtitle, or `NULL`

### gdata_feed_get_id ()

    const gchar *       gdata_feed_get_id                   (GDataFeed *self);

Returns the feed's unique and permanent URN ID.

`self` : | a GDataFeed
Returns : | the feed's ID

### gdata_feed_get_etag ()

    const gchar *       gdata_feed_get_etag                 (GDataFeed *self);

Returns the feed's unique ETag for this version.

`self` : | a GDataFeed
Returns : | the feed's ETag

Since 0.2.0

### gdata_feed_get_authors ()

    GList *             gdata_feed_get_authors              (GDataFeed *self);

Returns a list of the authors listed in this feed.

`self` : | a GDataFeed
Returns : | a GList of GDataAuthors. [element-type GData.Author][transfer none]

### gdata_feed_get_categories ()

    GList *             gdata_feed_get_categories           (GDataFeed *self);

Returns a list of the categories listed in this feed.

`self` : | a GDataFeed
Returns : | a GList of GDataCategorys. [element-type GData.Category][transfer none]

### gdata_feed_get_entries ()

    GList *             gdata_feed_get_entries              (GDataFeed *self);

Returns a list of the entries contained in this feed.

`self` : | a GDataFeed
Returns : | a GList of GDataEntrys. [element-type GData.Entry][transfer none]

### gdata_feed_look_up_entry ()

    GDataEntry *        gdata_feed_look_up_entry            (GDataFeed *self,
                                                             const gchar *id);

Returns the entry in the feed with the given `id`, if found.

`self` : | a GDataFeed
`id` : | the entry's ID
Returns : | the GDataEntry, or `NULL`. [transfer none]

Since 0.2.0

### gdata_feed_get_generator ()

    GDataGenerator *    gdata_feed_get_generator            (GDataFeed *self);

Returns details about the software which generated the feed.

`self` : | a GDataFeed
Returns : | a GDataGenerator, or `NULL`. [transfer none]

### gdata_feed_get_links ()

    GList *             gdata_feed_get_links                (GDataFeed *self);

Returns a list of the links listed in this feed.

`self` : | a GDataFeed
Returns : | a GList of GDataLinks. [element-type GData.Link][transfer none]

### gdata_feed_look_up_link ()

    GDataLink *         gdata_feed_look_up_link             (GDataFeed *self,
                                                             const gchar *rel);

Looks up a link by "relation-type" value from the list of links in the feed.

`self` : | a GDataFeed
`rel` : | the value of the "relation-type" property of the desired link
Returns : | a GDataLink, or `NULL` if one was not found. [transfer none]

Since 0.1.1

### gdata_feed_get_logo ()

    const gchar *       gdata_feed_get_logo                 (GDataFeed *self);

Returns the logo URI of the feed.

`self` : | a GDataFeed
Returns : | the feed's logo URI, or `NULL`

### gdata_feed_get_icon ()

    const gchar *       gdata_feed_get_icon                 (GDataFeed *self);

Returns the icon URI of the feed.

`self` : | a GDataFeed
Returns : | the feed's icon URI, or `NULL`

Since 0.6.0

### gdata_feed_get_updated ()

    gint64              gdata_feed_get_updated              (GDataFeed *self);

Gets the time the feed was last updated.

`self` : | a GDataFeed
Returns : | the UNIX timestamp for the time the feed was last updated

### gdata_feed_get_rights ()

    const gchar *       gdata_feed_get_rights               (GDataFeed *self);

Returns the rights pertaining to the entire feed, or `NULL` if not set.

`self` : | a GDataFeed
Returns : | the feed's rights information

Since 0.7.0

### gdata_feed_get_start_index ()

    guint               gdata_feed_get_start_index          (GDataFeed *self);

Returns the one-based start index of the results feed in the result set.

`self` : | a GDataFeed
Returns : | the one-based start index, or `0`

### gdata_feed_get_total_results ()

    guint               gdata_feed_get_total_results        (GDataFeed *self);

Returns the total number of results in the result set, including results on other pages.

`self` : | a GDataFeed
Returns : | the total number of results, or `0`

### gdata_feed_get_items_per_page ()

    guint               gdata_feed_get_items_per_page       (GDataFeed *self);

Returns the number of items per results page feed.

`self` : | a GDataFeed
Returns : | the number of items per results page feed, or `0`

## Property Details

### The `"etag"` property

      "etag"                     gchar*                : Read

The unique ETag for this version of the feed. See the online documentation for more information.

Default value: NULL

Since 0.2.0

### The `"generator"` property

      "generator"                GDataGenerator*       : Read

Details of the software used to generate the feed.

API reference: atom:generator

### The `"icon"` property

      "icon"                     gchar*                : Read

The URI of an icon for the feed.

API reference: atom:icon

Default value: NULL

Since 0.6.0

### The `"id"` property

      "id"                       gchar*                : Read

The unique and permanent URN ID for the feed.

API reference: atom:id

Default value: NULL

### The `"items-per-page"` property

      "items-per-page"           guint                 : Read

The number of items per results page feed.

API reference: openSearch:itemsPerPage

Default value: 0

### The `"logo"` property

      "logo"                     gchar*                : Read

The URI of a logo for the feed.

API reference: atom:logo

Default value: NULL

### The `"rights"` property

      "rights"                   gchar*                : Read

The ownership rights pertaining to the entire feed.

For more information, see the Atom specification.

Default value: NULL

Since 0.7.0

### The `"start-index"` property

      "start-index"              guint                 : Read

The one-based index of the first item in the results feed.

This should not be used manually for pagination. Instead, use a GDataQuery and call its `gdata_query_next_page()` or `gdata_query_previous_page()` functions before making the query to the service.

API reference: openSearch:startIndex

Allowed values: >= 1

Default value: 1

### The `"subtitle"` property

      "subtitle"                 gchar*                : Read

The subtitle of the feed.

API reference: atom:subtitle

Default value: NULL

### The `"title"` property

      "title"                    gchar*                : Read

The title of the feed.

API reference: atom:title

Default value: NULL

### The `"total-results"` property

      "total-results"            guint                 : Read

The number of items in the result set for the feed, including those on other pages.

This should not be used manually for pagination. Instead, use a GDataQuery and call its `gdata_query_next_page()` or `gdata_query_previous_page()` functions before making the query to the service.

API reference: openSearch:totalResults

Allowed values: <= 1000000

Default value: 0

### The `"updated"` property

      "updated"                  gint64                : Read

The time the feed was last updated.

API reference: atom:updated

Allowed values: >= 0

Default value: 0