Class GoogleWebAuthorizationBroker (1.50.0)

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
Type	Description
`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
Name	Description
`clientSecrets`	`ClientSecrets` The client secrets.
`scopes`	`IEnumerable<String>` The scopes which indicate the Google API access your application is requesting.
`user`	`String` The user to authorize.
`taskCancellationToken`	`CancellationToken` Cancellation token to cancel an operation.
`dataStore`	`IDataStore` The data store, if not specified a file data store will be used.
`codeReceiver`	`ICodeReceiver` The code receiver, if not specified a local server code receiver will be used.

Returns
Type	Description
`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
Name	Description
`initializer`	`GoogleAuthorizationCodeFlow.Initializer` The authorization code initializer.
`scopes`	`IEnumerable<String>` The scopes which indicate the Google API access your application is requesting.
`user`	`String` The user to authorize.
`taskCancellationToken`	`CancellationToken` Cancellation token to cancel an operation.
`dataStore`	`IDataStore` The data store, if not specified a file data store will be used.
`codeReceiver`	`ICodeReceiver` The code receiver, if not specified a local server code receiver will be used.

Returns
Type	Description
`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
Name	Description
`clientSecretsStream`	`Stream` The client secrets stream. The authorization code flow constructor is responsible for disposing the stream.
`scopes`	`IEnumerable<String>` The scopes which indicate the Google API access your application is requesting.
`user`	`String` The user to authorize.
`taskCancellationToken`	`CancellationToken` Cancellation token to cancel an operation.
`dataStore`	`IDataStore` The data store, if not specified a file data store will be used.
`codeReceiver`	`ICodeReceiver` The code receiver, if not specified a local server code receiver will be used.

Returns
Type	Description
`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
Name	Description
`userCredential`	`UserCredential` The current user credential. Its Token will be updated.
`taskCancellationToken`	`CancellationToken` Cancellation token to cancel an operation.
`codeReceiver`	`ICodeReceiver` The code receiver, if not specified a local server code receiver will be used.

Returns
Type	Description
`Task`

Extension Method

Utilities.ThrowIfNull<T>(T, String)