EDataServer.GDataSession
Description: Reference for EDataServer.GDataSession

### Class

# EDataServerGDataSession

since: 3.46

#### Description

    class EDataServer.GDataSession : EDataServer.SoupSession
    {
      /* No available fields */
    }

No description available.

Available since: 3.46

#### Hierarchy

#### Ancestors

- ESoupSession
- SoupSession
- GObject

#### Constructors

###### e_gdata_session_new

Creates a new `EGDataSession` associated with the given `source`.

since: 3.46

#### Instance methods

###### e_gdata_session_tasklists_delete_sync

Deletes a task list `tasklist_id`.

since: 3.46

###### e_gdata_session_tasklists_get_sync

Gets a task list `tasklist_id` and returns it as a `JsonObject`, which should be freed with json_object_unref(), when no longer needed.

since: 3.46

###### e_gdata_session_tasklists_insert_sync

Creates a new task list, titled `title`. The `out_inserted_tasklist` should be freed with json_object_unref(), when no longer needed.

since: 3.46

###### e_gdata_session_tasklists_list_sync

Lists all configured task lists for the user, calling the `cb` for each of them.

since: 3.46

###### e_gdata_session_tasklists_patch_sync

Changes properties of a task list `tasklist_id`.

since: 3.46

###### e_gdata_session_tasklists_update_sync

Updates a task list `tasklist_id` with values from the `tasklist`.

since: 3.46

###### e_gdata_session_tasks_clear_sync

Clears all completed tasks from the task list `tasklist_id`. The affected tasks will be marked as ‘hidden’ and no longer be returned by default when retrieving all tasks for a task list.

since: 3.46

###### e_gdata_session_tasks_delete_sync

Deletes a task `task_id` from a task list `tasklist_id`.

since: 3.46

###### e_gdata_session_tasks_get_sync

Gets a task `task_id` from a task list `tasklist_id` and returns it as a `JsonObject`, which should be freed with json_object_unref(), when no longer needed.

since: 3.46

###### e_gdata_session_tasks_insert_sync

Creates a new task `task` in the task list `tasklist_id`. The `out_inserted_task` should be freed with json_object_unref(), when no longer needed.

since: 3.46

###### e_gdata_session_tasks_list_sync

Lists all tasks in the task list `tasklist_id`, calling the `cb` for each of them.

since: 3.46

###### e_gdata_session_tasks_move_sync

Moves the specified task `task_id` to another position in the task list `tasklist_id`. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks.

since: 3.46

###### e_gdata_session_tasks_patch_sync

Changes properties `task_properties` of a task `task_id` in the task list `tasklist_id`.

since: 3.46

###### e_gdata_session_tasks_update_sync

Updates a task `task_id` in a task list `tasklist_id` to the values from the `task`.

since: 3.46

##### Methods inherited from ESoupSession (20)

###### e_soup_session_check_result

Checks result of the `message` and sets the `error` if it failed. When it failed and the `read_bytes` is provided, then these are set to `message`‘s response body, thus it can be used later.

since: 3.26

###### e_soup_session_dup_credentials

No description available.

since: 3.26

###### e_soup_session_get_authentication_requires_credentials

No description available.

since: 3.28

###### e_soup_session_get_force_http1

Returns whether it’s forced to use HTTP/1 for the messages created by the `session`. See `e_soup_session_set_force_http1()` for more information about the limitations.

since: 3.48

###### e_soup_session_get_handle_backoff_responses

Returns whether the `session` can handle backoff responses from the server. See `e_soup_session_set_handle_backoff_responses()` for more information about the limitations.

since: 3.54

###### e_soup_session_get_log_level

No description available.

since: 3.26

###### e_soup_session_get_source

Returns an `ESource` associated with the `session`, if such was set in the creation time.

since: 3.26

###### e_soup_session_get_ssl_error_details

Populates `out_certificate_pem` and `out_certificate_errors` with the last values returned on #G_TLS_ERROR_BAD_CERTIFICATE error.

since: 3.26

###### e_soup_session_handle_authentication_failure

Handles authentication failure and sets appropriate value to the `out_auth_result` for the provided `op_error` and used `credentials`. Converts the `op_error` into an appropriate error returned in the `error`.

since: 3.46

###### e_soup_session_new_message

Creates a new `SoupMessage`, similar to soup_message_new(), but also presets request headers with “User-Agent” to be “Evolution/version” and with “Connection” to be “close”.

since: 3.26

###### e_soup_session_new_message_from_uri

Creates a new `SoupMessage`, similar to soup_message_new_from_uri(), but also presets request headers with “User-Agent” to be “Evolution/version” and with “Connection” to be “close”.

since: 3.46

###### e_soup_session_prepare_message_send_sync

Prepares the `message` to be a sent asynchronously with e_soup_session_send_message(). The returned pointer is passed to the `e_soup_session_send_message()` as the prepare_data parameter.

since: 3.46

###### e_soup_session_send_message

Asynchronously sends the `message`. Finish the call with e_soup_session_send_message_finish().

since: 3.46

###### e_soup_session_send_message_finish

Finishes the call of e_soup_session_send_message(). This is supposed to be called from the callback passed to the e_soup_session_send_message().

since: 3.46

###### e_soup_session_send_message_simple_sync

Similar to e_soup_session_send_message_sync(), except it reads whole response content into memory and returns it as a `GByteArray`. Use `e_soup_session_send_message_sync()` when you want to have more control on the content read.

since: 3.26

###### e_soup_session_send_message_sync

Synchronously sends prepared message and returns `GInputStream` that can be used to read its contents.

since: 3.26

###### e_soup_session_set_credentials

Sets credentials to use for connection. Using `NULL` for `credentials` unsets previous value.

since: 3.26

###### e_soup_session_set_force_http1

Sets whether the messages created through the `session` using `e_soup_session_new_message()` or `e_soup_session_new_message_from_uri()` should force use of the HTTP/1, instead of trying HTTP/2 and fallback to HTTP/1, when the newer version cannot be used.

since: 3.48

###### e_soup_session_set_handle_backoff_responses

Sets whether to automatically handle backoff responses from the server, that is, when the server requests the client to retry later.

since: 3.54

###### e_soup_session_setup_logging

Setups logging for the `session`. The `logging_level` can be one of: “all” - log whole raw communication; “body” - the same as “all”; “headers” - log the headers only; “min” - minimal logging; “1” - the same as “all”. Any other value, including `NULL`, disables logging.

since: 3.26

##### Methods inherited from SoupSession (42)

Please see SoupSession for a full list of methods.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

##### Properties inherited from ESoupSession (4)

###### EDataServer.SoupSession:credentials

The `ENamedParameters` containing login credentials.

since: 3.26

###### EDataServer.SoupSession:force-http1

Whether the messages created by the session should force use of HTTP/1 instead of trying HTTP/2 first and fallback to the HTTP/1 when the newer version failed to connect.

since: 3.48

###### EDataServer.SoupSession:handle-backoff-responses

Set to `TRUE`, which is the default, to automatically handle backoff responses from the server, that is, when the server requests the client to retry later.

since: 3.54

###### EDataServer.SoupSession:source

The `ESource` being used for this soup session.

since: 3.26

##### Properties inherited from SoupSession (12)

###### Soup.Session:accept-language

If non-`NULL`, the value to use for the “Accept-Language” header on `SoupMessage`s sent from this session.

###### Soup.Session:accept-language-auto

If `TRUE`, `SoupSession` will automatically set the string for the “Accept-Language” header on every `SoupMessage` sent, based on the return value of `g_get_language_names()`.

###### Soup.Session:idle-timeout

Connection lifetime (in seconds) when idle. Any connection left idle longer than this will be closed.

###### Soup.Session:local-address

Sets the `GInetSocketAddress` to use for the client side of the connection.

###### Soup.Session:max-conns

The maximum number of connections that the session can open at once.

###### Soup.Session:max-conns-per-host

The maximum number of connections that the session can open at once to a given host.

###### Soup.Session:proxy-resolver

A `GProxyResolver` to use with this session.

###### Soup.Session:remote-connectable

Sets a socket to make outgoing connections on. This will override the default behaviour of opening TCP/IP sockets to the hosts specified in the URIs.

###### Soup.Session:timeout

The timeout (in seconds) for socket I/O operations (including connecting to a server, and waiting for a reply to an HTTP request).

###### Soup.Session:tls-database

Sets the `GTlsDatabase` to use for validating SSL/TLS certificates.

###### Soup.Session:tls-interaction

A `GTlsInteraction` object that will be passed on to any `GTlsConnection`s created by the session.

###### Soup.Session:user-agent

User-Agent string.

#### Signals

##### Signals inherited from SoupSession (2)

###### SoupSession::request-queued

Emitted when a request is queued on `session`.

###### SoupSession::request-unqueued

Emitted when a request is removed from `session`‘s queue, indicating that `session` is done with it.

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct EDataServerGDataSessionClass {
      ESoupSessionClass parent_class;
      gpointer reserved;

    }

No description available.

###### Class members

`parent_class: ESoupSessionClass`

  No description available.

`reserved: gpointer`

  No description available.