Method: projects.locations.userEvents.collect

브라우저에서 단일 사용자 이벤트를 작성합니다. 서드 파티 도메인에 POST할 수 없다는 브라우저 제한으로 인해 GET 요청을 사용합니다.

이 메서드는 Discovery Engine API JavaScript 픽셀과 Google 태그 관리자에서만 사용됩니다. 사용자는 이 메서드를 직접 호출하면 안 됩니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

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

쿼리 매개변수

매개변수
userEvent

string

필수 항목입니다. 길이 제한이 2,000,000자인 URL 인코딩된 UserEvent proto입니다.
uri

string

cgi 파라미터를 포함하고 해시 프래그먼트를 제외한 URL입니다. 길이는 5,000자로 제한됩니다. 많은 브라우저가 서드 파티 요청에 대해서만 도메인을 전송하므로 이는 리퍼러 URL보다 유용할 때가 많습니다.
ets

string (int64 format)

이벤트 타임스탬프(밀리초)입니다. 이렇게 하면 동일한 GET 요청이 브라우저에서 캐싱되는 것을 방지합니다. 페이로드 바이트를 줄이기 위해 이름이 축약됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답은 형식이 메서드에 의해 정의되는 일반 HTTP 응답입니다.

승인 범위

다음 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를 참조하세요.