Method: projects.locations.userEvents.write

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

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/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 문서를 참조하세요.