## GDataDocumentsFolder

GDataDocumentsFolder — GData documents folder object

## Stability Level

Stable, unless otherwise indicated

## Functions

GDataDocumentsFolder * | gdata_documents_folder_new ()

## Types and Values

| GDataDocumentsFolder
| GDataDocumentsFolderClass

## Object Hierarchy

        GObject
        ╰── GDataParsable
            ╰── GDataEntry
                ╰── GDataDocumentsEntry
                    ╰── GDataDocumentsFolder

## Implemented Interfaces

GDataDocumentsFolder implements GDataAccessHandler.

## Includes

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

## Description

GDataDocumentsFolder is a subclass of GDataDocumentsEntry to represent a folder from Google Documents.

For more details of Google Documents' GData API, see the

online documentation.

Example 36. Adding a Folder

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29

    GDataDocumentsService *service;
    GDataDocumentsFolder *folder, *new_folder;
    gchar *upload_uri;
    GError *error = NULL;

    /* Create a service */
    service = create_documents_service ();

    /* Create the new folder */
    folder = gdata_documents_folder_new (NULL);
    gdata_entry_set_title (GDATA_ENTRY (folder), "Folder Name");

    /* Insert the folder */
    upload_uri = gdata_documents_service_get_upload_uri (NULL);
    new_folder = GDATA_DOCUMENTS_FOLDER (gdata_service_insert_entry (GDATA_SERVICE (service), upload_uri, GDATA_ENTRY (folder), NULL, &error));
    g_free (upload_uri);

    g_object_unref (folder);
    g_object_unref (service);

    if (error != NULL) {
        g_error ("Error inserting new folder: %s", error->message);
        g_error_free (error);
        return;
    }

    /* Do something with the new folder, such as store its ID for future use */

    g_object_unref (new_folder);

## Functions

### gdata_documents_folder_new ()

    GDataDocumentsFolder *
    gdata_documents_folder_new (const gchar *id);

Creates a new GDataDocumentsFolder with the given entry ID (“id”).

#### Parameters

id | the entry's ID (not the document ID of the folder), or `NULL`. | [allow-none]

#### Returns

a new GDataDocumentsFolder, or `NULL`; unref with `g_object_unref()`

Since: 0.4.0

## Types and Values

### GDataDocumentsFolder

    typedef struct _GDataDocumentsFolder GDataDocumentsFolder;

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

Since: 0.4.0

### GDataDocumentsFolderClass

    typedef struct {
    } GDataDocumentsFolderClass;

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

Since: 0.4.0