Method: projects.locations.userEvents.collect

Menulis satu peristiwa pengguna dari browser. Hal ini menggunakan permintaan GET karena pembatasan browser untuk mengirim POST ke domain pihak ketiga.

Metode ini hanya digunakan oleh piksel JavaScript Discovery Engine API dan Google Tag Manager. Pengguna tidak boleh memanggil metode ini secara langsung.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama resource induk. Jika tindakan kumpulkan peristiwa pengguna diterapkan di tingkat DataStore, formatnya adalah: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Jika tindakan kumpulkan peristiwa pengguna diterapkan di tingkat Location, misalnya, peristiwa dengan Document di beberapa DataStore, formatnya adalah: projects/{project}/locations/{location}.

Parameter kueri

Parameter
userEvent

string

Wajib. Proto UserEvent yang dienkode URL dengan batas panjang 2.000.000 karakter.
uri

string

URL yang menyertakan parameter cgi,tetapi tidak menyertakan fragmen hash dengan batas panjang 5.000 karakter. Hal ini sering kali lebih berguna daripada URL perujuk, karena banyak browser hanya mengirimkan domain untuk permintaan pihak ketiga.
ets

string (int64 format)

Stempel waktu peristiwa dalam milidetik. Hal ini mencegah browser menyimpan dalam cache permintaan get yang identik. Nama disingkat untuk mengurangi byte payload.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, responsnya adalah respons HTTP generik yang formatnya ditentukan oleh metode.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.