Method: projects.locations.userEvents.collect

從瀏覽器寫入單一使用者事件。由於瀏覽器限制向第三方網域發布 POST，因此這項作業會使用 GET 要求。

這個方法僅供 Discovery Engine API JavaScript 像素和 Google 代碼管理工具使用。使用者不應直接呼叫這個方法。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標，父項資源名稱。如果是在 DataStore 層級套用收集使用者事件動作，格式為：projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}。舉例來說，如果在 Location 層級套用收集使用者事件動作，且事件具有多個 DataStore 的 Document，格式為：projects/{project}/locations/{location}。

查詢參數

參數
userEvent

string

這是必要旗標，網址編碼的 UserEvent proto，長度限制為 2,000,000 個字元。
uri

string

網址 (包括 CGI 參數，但不包括雜湊片段)，長度上限為 5,000 個半形字元。相較於參照網址，這項資訊通常更有用，因為許多瀏覽器只會傳送第三方要求的網域。
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。