Class GoogleWebAuthorizationBroker

public class GoogleWebAuthorizationBroker : object

A helper utility to manage the authorization code flow.

Inheritance

Object > GoogleWebAuthorizationBroker

Namespace

Google.Apis.Auth.OAuth2

Assembly

Google.Apis.Auth.dll

Remarks

This class is only suitable for client-side use, as it starts a local browser that requires user interaction. Do not use this class when executing on a web server, or any cases where the authenticating end-user is not able to do directly interact with a launched browser.

Fields

Folder

public static string Folder

The folder which is used by the FileDataStore.

Field Value
TypeDescription
String
Remarks

The reason that this is not 'private const' is that a user can change it and store the credentials in a different location.

Methods

AuthorizeAsync(ClientSecrets, IEnumerable<String>, String, CancellationToken, IDataStore, ICodeReceiver)

public static Task<UserCredential> AuthorizeAsync(ClientSecrets clientSecrets, IEnumerable<string> scopes, string user, CancellationToken taskCancellationToken, IDataStore dataStore = null, ICodeReceiver codeReceiver = null)

Asynchronously authorizes the specified user. Requires user interaction; see GoogleWebAuthorizationBroker remarks for more details.

Parameters
TypeNameDescription
ClientSecretsclientSecrets

The client secrets.

IEnumerable<String>scopes

The scopes which indicate the Google API access your application is requesting.

Stringuser

The user to authorize.

CancellationTokentaskCancellationToken

Cancellation token to cancel an operation.

IDataStoredataStore

The data store, if not specified a file data store will be used.

ICodeReceivercodeReceiver

The code receiver, if not specified a local server code receiver will be used.

Returns
TypeDescription
Task<UserCredential>

User credential.

Remarks

In case no data store is specified, FileDataStore will be used by default.

AuthorizeAsync(GoogleAuthorizationCodeFlow.Initializer, IEnumerable<String>, String, CancellationToken, IDataStore, ICodeReceiver)

public static Task<UserCredential> AuthorizeAsync(GoogleAuthorizationCodeFlow.Initializer initializer, IEnumerable<string> scopes, string user, CancellationToken taskCancellationToken, IDataStore dataStore = null, ICodeReceiver codeReceiver = null)

The core logic for asynchronously authorizing the specified user. Requires user interaction; see GoogleWebAuthorizationBroker remarks for more details.

Parameters
TypeNameDescription
GoogleAuthorizationCodeFlow.Initializerinitializer

The authorization code initializer.

IEnumerable<String>scopes

The scopes which indicate the Google API access your application is requesting.

Stringuser

The user to authorize.

CancellationTokentaskCancellationToken

Cancellation token to cancel an operation.

IDataStoredataStore

The data store, if not specified a file data store will be used.

ICodeReceivercodeReceiver

The code receiver, if not specified a local server code receiver will be used.

Returns
TypeDescription
Task<UserCredential>

User credential.

AuthorizeAsync(Stream, IEnumerable<String>, String, CancellationToken, IDataStore, ICodeReceiver)

public static Task<UserCredential> AuthorizeAsync(Stream clientSecretsStream, IEnumerable<string> scopes, string user, CancellationToken taskCancellationToken, IDataStore dataStore = null, ICodeReceiver codeReceiver = null)

Asynchronously authorizes the specified user. Requires user interaction; see GoogleWebAuthorizationBroker remarks for more details.

Parameters
TypeNameDescription
StreamclientSecretsStream

The client secrets stream. The authorization code flow constructor is responsible for disposing the stream.

IEnumerable<String>scopes

The scopes which indicate the Google API access your application is requesting.

Stringuser

The user to authorize.

CancellationTokentaskCancellationToken

Cancellation token to cancel an operation.

IDataStoredataStore

The data store, if not specified a file data store will be used.

ICodeReceivercodeReceiver

The code receiver, if not specified a local server code receiver will be used.

Returns
TypeDescription
Task<UserCredential>

User credential.

Remarks

In case no data store is specified, FileDataStore will be used by default.

ReauthorizeAsync(UserCredential, CancellationToken, ICodeReceiver)

public static Task ReauthorizeAsync(UserCredential userCredential, CancellationToken taskCancellationToken, ICodeReceiver codeReceiver = null)

Asynchronously reauthorizes the user. This method should be called if the users want to authorize after they revoked the token. Requires user interaction; see GoogleWebAuthorizationBroker remarks for more details.

Parameters
TypeNameDescription
UserCredentialuserCredential

The current user credential. Its Token will be updated.

CancellationTokentaskCancellationToken

Cancellation token to cancel an operation.

ICodeReceivercodeReceiver

The code receiver, if not specified a local server code receiver will be used.

Returns
TypeDescription
Task

Extension Method