Blame docs/reference/html/GDataGoaAuthorizer.html

Packit 4b6dd7
Packit 4b6dd7
<html>
Packit 4b6dd7
<head>
Packit 4b6dd7
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit 4b6dd7
<title>GDataGoaAuthorizer: GData Reference Manual</title>
Packit 4b6dd7
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit 4b6dd7
<link rel="home" href="index.html" title="GData Reference Manual">
Packit 4b6dd7
<link rel="up" href="ch05.html" title="Authentication/Authorization API">
Packit 4b6dd7
<link rel="prev" href="GDataClientLoginAuthorizer.html" title="GDataClientLoginAuthorizer">
Packit 4b6dd7
<link rel="next" href="GDataOAuth1Authorizer.html" title="GDataOAuth1Authorizer">
Packit 4b6dd7
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit 4b6dd7
<link rel="stylesheet" href="style.css" type="text/css">
Packit 4b6dd7
</head>
Packit 4b6dd7
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Top  | 
Packit 4b6dd7
                  Description  | 
Packit 4b6dd7
                  Object Hierarchy  | 
Packit 4b6dd7
                  Implemented Interfaces  | 
Packit 4b6dd7
                  Properties
Packit 4b6dd7
Packit 4b6dd7
Home
Packit 4b6dd7
Up
Packit 4b6dd7
Prev
Packit 4b6dd7
Next
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDataGoaAuthorizer

Packit 4b6dd7

GDataGoaAuthorizer — GData GOA authorization interface

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Stability Level

Packit 4b6dd7
Packit 4b6dd7
develop applications to these interfaces, release them, and have confidence that
Packit 4b6dd7
they will run on all minor releases of the product (after the one in which the
Packit 4b6dd7
interface was introduced, and within the same major release). Even at a major
Packit 4b6dd7
release, incompatible changes are expected to be rare, and to have strong
Packit 4b6dd7
justifications.
Packit 4b6dd7
">Stable, unless otherwise indicated
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataGoaAuthorizer *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_goa_authorizer_new ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GoaObject *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_goa_authorizer_get_goa_object ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Properties

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GoaObject *
Packit 4b6dd7
goa-object
Packit 4b6dd7
Read / Write / Construct Only
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataGoaAuthorizer
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataGoaAuthorizerClass
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Object Hierarchy

Packit 4b6dd7
    GObject
Packit 4b6dd7
    ╰── GDataGoaAuthorizer
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Implemented Interfaces

Packit 4b6dd7

Packit 4b6dd7
GDataGoaAuthorizer implements
Packit 4b6dd7
 GDataAuthorizer.

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Includes

Packit 4b6dd7
#include <gdata/gdata-goa-authorizer.h>
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Description

Packit 4b6dd7

GDataGoaAuthorizer provides an implementation of the GDataAuthorizer interface for authentication and authorization using GNOME Online Accounts

Packit 4b6dd7
(GOA) over D-Bus. This allows a single login session (managed by the GOA daemon) to be used by multiple applications simultaneously, without each
Packit 4b6dd7
of those applications having to go through the authentication process themselves. Applications making use of GDataGoaAuthorizer don't get access
Packit 4b6dd7
to the user's password (it's handled solely by the GOA daemon).

Packit 4b6dd7

Internally, GOA authenticates with the Google servers using the

Packit 4b6dd7
OAuth 1.0 or
Packit 4b6dd7
OAuth 2.0 processes.
Packit 4b6dd7

GDataGoaAuthorizer natively supports authorization against multiple services (unlike GDataClientLoginAuthorizer), depending entirely on which

Packit 4b6dd7
services the user has enabled for their Google account in GOA. GDataGoaAuthorizer cannot authenticate for more services than are enabled in GOA.

Packit 4b6dd7
Packit 4b6dd7

Example 7. Authenticating Using GOA

Packit 4b6dd7
Packit 4b6dd7
  
Packit 4b6dd7
    
Packit 4b6dd7
      
Packit 4b6dd7
        
1
Packit 4b6dd7
2
Packit 4b6dd7
3
Packit 4b6dd7
4
Packit 4b6dd7
5
Packit 4b6dd7
6
Packit 4b6dd7
7
Packit 4b6dd7
8
Packit 4b6dd7
9
Packit 4b6dd7
10
Packit 4b6dd7
11
Packit 4b6dd7
12
Packit 4b6dd7
13
Packit 4b6dd7
14
Packit 4b6dd7
15
Packit 4b6dd7
16
Packit 4b6dd7
        
GDataSomeService *service;
Packit 4b6dd7
GoaObject *goa_object;
Packit 4b6dd7
GDataGoaAuthorizer *authorizer;
Packit 4b6dd7
Packit 4b6dd7
/* Create an authorizer and pass it an existing #GoaObject. */
Packit 4b6dd7
goa_object = get_goa_object ();
Packit 4b6dd7
authorizer = gdata_goa_authorizer_new (goa_object);
Packit 4b6dd7
Packit 4b6dd7
/* Create a service object and link it with the authorizer */
Packit 4b6dd7
service = gdata_some_service_new (GDATA_AUTHORIZER (authorizer));
Packit 4b6dd7
Packit 4b6dd7
/* Use the service! */
Packit 4b6dd7
Packit 4b6dd7
g_object_unref (service);
Packit 4b6dd7
g_object_unref (authorizer);
Packit 4b6dd7
g_object_unref (goa_object);
Packit 4b6dd7
      
Packit 4b6dd7
    
Packit 4b6dd7
  
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7

gdata_goa_authorizer_new ()

Packit 4b6dd7
GDataGoaAuthorizer *
Packit 4b6dd7
gdata_goa_authorizer_new (GoaObject *goa_object);
Packit 4b6dd7

Create a new GDataGoaAuthorizer using the authentication token from the given goa_object

Packit 4b6dd7
.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

goa_object

Packit 4b6dd7

the GOA account providing authentication.

Packit 4b6dd7
[transfer none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a new GDataGoaAuthorizer; unref with g_object_unref().

Packit 4b6dd7

[transfer full]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.13.1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_goa_authorizer_get_goa_object ()

Packit 4b6dd7
GoaObject *
Packit 4b6dd7
gdata_goa_authorizer_get_goa_object (GDataGoaAuthorizer *self);
Packit 4b6dd7

The GOA account providing authentication. This is the same as “goa-object”.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataGoaAuthorizer

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the GOA account providing authentication.

Packit 4b6dd7

[transfer none]

Packit 4b6dd7
Packit 4b6dd7

Since: 0.13.1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7

GDataGoaAuthorizer

Packit 4b6dd7
typedef struct _GDataGoaAuthorizer GDataGoaAuthorizer;
Packit 4b6dd7

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

Packit 4b6dd7

Since: 0.13.1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

GDataGoaAuthorizerClass

Packit 4b6dd7
typedef struct {
Packit 4b6dd7
} GDataGoaAuthorizerClass;
Packit 4b6dd7
Packit 4b6dd7

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

Packit 4b6dd7

Since: 0.13.1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Property Details

Packit 4b6dd7
Packit 4b6dd7

The “goa-object” property

Packit 4b6dd7
  “goa-object”               GoaObject *
Packit 4b6dd7

The GOA account providing authentication. This should have all the necessary services enabled on it.

Packit 4b6dd7

Flags: Read / Write / Construct Only

Packit 4b6dd7

Since: 0.13.1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Generated by GTK-Doc V1.26.1
Packit 4b6dd7
</body>
Packit 4b6dd7
</html>