Method: projects.locations.collections.dataStores.userEvents.write

단일 사용자 이벤트를 작성합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:write

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

경로 파라미터

파라미터
parent

string

필수 항목. 상위 리소스 이름입니다. 사용자 이벤트 기록 작업이 DataStore 수준에서 적용되는 경우 형식은 projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}입니다. 사용자 이벤트 기록 작업이 Location 수준에서 적용되는 경우(예: 여러 DataStore에 걸쳐 Document이 있는 이벤트) 형식은 projects/{project}/locations/{location}입니다.

쿼리 파라미터

파라미터
writeAsync

boolean

true로 설정하면 사용자 이벤트는 유효성 검사 후 비동기적으로 기록되며 API는 기록 작업이 완료될 때까지 기다리지 않고 바로 응답합니다.

요청 본문

요청 본문에 UserEvent의 인스턴스가 포함됩니다.

응답 본문

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

승인 범위

다음 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.create

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