Method: projects.locations.collections.dataConnector.acquireAndStoreRefreshToken

Exchanges OAuth authorization credentials for a refresh token and stores the refresh token and the scopes. The stored data will be keyed by the connector name and the user identifier from the EUC.

HTTP request

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}:acquireAndStoreRefreshToken

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Connector resource.

The connector name identifies the 3rd party system to use for authorization. It is also used as a key to store the refresh token.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "scopes": [
    string
  ],
  "fullRedirectUri": string
}
Fields
scopes[]

string

The scopes of the authorization code and the refresh token.
fullRedirectUri

string

Required. The URI the user is redirected to after authorization, including all parameters. E.g., https://example.com/redir?code=5

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • discoveryengine.dataConnectors.acquireAndStoreRefreshToken

For more information, see the IAM documentation.