Method: projects.locations.collections.dataConnector.acquireAccessToken

Uses the per-user refresh token minted with dataConnector.acquireAndStoreRefreshToken to generate and return a new access token and its details. Takes the access token from cache if available. Rotates the stored refresh token if needed. uses the end user identity to return the user specific access token. Does not return the credentials configured by the administrator. Used by Agentspace action execution and Agentspace UI.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The resource name of the connector for which a token is queried.

Request body

The request body must be empty.

Response body

Response message for the DataConnectorService.AcquireAccessToken method.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "refreshTokenInfo": {
    object (RefreshTokenInfo)
  },
  "accessToken": string
}
Fields
refreshTokenInfo

object (RefreshTokenInfo)

Info about the stored refresh token used to create the access token.
accessToken

string

The created access token.

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.acquireAccessToken

For more information, see the IAM documentation.