Method: projects.locations.collections.dataConnector.acquireAndStoreRefreshToken

OAuth 승인 사용자 인증 정보를 갱신 토큰으로 교환하고 갱신 토큰과 범위를 저장합니다. 저장된 데이터는 커넥터 이름과 EUC의 사용자 식별자를 기준으로 키가 지정됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 커넥터 리소스입니다.

커넥터 이름은 승인에 사용할 서드 파티 시스템을 식별합니다. 또한 갱신 토큰을 저장하는 키로도 사용됩니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "scopes": [
    string
  ],
  "fullRedirectUri": string
}
필드
scopes[]

string

승인 코드 및 갱신 토큰의 범위입니다.
fullRedirectUri

string

필수 항목입니다. 모든 매개변수를 포함하여 승인 후 사용자가 리디렉션되는 URI입니다. 예: https://example.com/redir?code=5

응답 본문

DataConnectorService.AcquireAndStoreRefreshToken 메서드의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "additionalOauthResponses": [
    {
      object (AdditionalOAuthResponse)
    }
  ]
}
필드
additionalOauthResponses[]

object (AdditionalOAuthResponse)

(선택사항) 승인 응답의 추가 OAuth 응답입니다. 이 필드는 선택사항이며 항상 입력되지는 않습니다. 커넥터의 유형과 승인 응답에 따라 다릅니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • discoveryengine.dataConnectors.acquireAndStoreRefreshToken

자세한 내용은 IAM 문서를 참조하세요.

AdditionalOAuthResponse

승인 응답의 추가 OAuth 응답입니다.

JSON 표현 
{
  "key": string,

  // Union field value can be only one of the following:
  "stringValue": string,
  "intValue": string,
  "boolValue": boolean
  // End of list of possible types for union field value.
}
필드
key

string

추가 OAuth 응답의 키입니다.
통합 필드 value. 추가 OAuth 응답의 값입니다. value은 다음 중 하나여야 합니다.
stringValue

string

추가 OAuth 응답의 문자열 값입니다.
intValue

string (int64 format)

추가 OAuth 응답의 정수 값입니다.
boolValue

boolean

추가 OAuth 응답의 불리언 값입니다.