Method: projects.locations.collections.engines.sessions.validateUserAuthorization

Valida um fluxo de consentimento de autenticação downstream do OAuth de três etapas (3LO) do A2A depois que o usuário retorna da tela de permissão de terceiros e finaliza a credencial downstream com o Auth Manager.

Solicitação HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{session=projects/*/locations/*/collections/*/engines/*/sessions/*}:validateUserAuthorization

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
session

string

Obrigatório. O nome do recurso da sessão do Google Assistente que iniciou o fluxo de consentimento. Usado com downstreamConnector para recuperar o consent_nonce armazenado no servidor. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "userIdValidationState": string,
  "downstreamConnector": string
}
Campos
userIdValidationState

string (bytes format)

Obrigatório. O estado de validação opaco e criptografado retornado pelo Auth Manager no redirecionamento de consentimento. Encaminhado literalmente para FinalizeCredentials.

Uma string codificada em base64.
downstreamConnector

string

Obrigatório. O nome do recurso do conector downstream (provedor de autenticação) do redirecionamento de consentimento (auth_provider_name). Nomeado downstreamConnector para evitar ambiguidade com o "conector" no agente remoto.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.