Method: projects.locations.userEvents.import

사용자 이벤트를 일괄 가져옵니다. 요청 처리는 동기식일 수 있습니다. 이미 존재하는 이벤트는 건너뜁니다. 이전 사용자 이벤트를 백필하는 데 이 메서드를 사용합니다.

Operation.response는 ImportResponse 유형입니다. 항목의 하위 집합이 성공적으로 삽입될 수 있습니다. Operation.metadata는 ImportMetadata 유형입니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/userEvents:import

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 상위 DataStore 리소스 이름입니다(projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore} 형식).

요청 본문

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

JSON 표현
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of list of possible types for union field source.
}
필드
errorConfig

object (ImportErrorConfig)

가져오기 중에 발생하는 오류의 원하는 위치입니다. 인라인 사용자 이벤트 가져오기에는 설정할 수 없습니다.

통합 필드 source. 필수 - 사용자 이벤트 데이터의 원하는 입력 소스입니다. source은 다음 중 하나여야 합니다.
inlineSource

object (InlineSource)

UserEvents의 입력 콘텐츠에 대한 인라인 소스입니다.

gcsSource

object (GcsSource)

입력 콘텐츠의 Cloud Storage 위치입니다.

bigquerySource

object (BigQuerySource)

BigQuery 입력 소스입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 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 권한

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

  • discoveryengine.userEvents.import

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