cara mendorong data yang dikumpulkan, apa saja parameternya - OpenSearch

Mendorong satu batch catatan perilaku pengguna atau atribut ke dalam pengumpulan data di aplikasi OpenSearch.

Sintaksis permintaan

POST /v3/openapi/app-groups/{appName}/data-collections/{dataCollectionName}/data-collection-type/{dataCollectionType}/actions/bulk

Parameter path

Parameter	Deskripsi
`appName`	Nama aplikasi OpenSearch.
`dataCollectionName`	Nama pengumpulan data. Nilai default-nya adalah nama aplikasi OpenSearch.
`dataCollectionType`	Jenis data yang akan didorong. Nilai yang valid: `USER`, `ITEM_INFO`, `BEHAVIOR`, `INDUSTRY_SPECIFIC`.

Titik akhir dan parameter header permintaan tidak disertakan dalam URL di atas. Untuk struktur permintaan lengkap, lihat Request structure.

Badan permintaan

Badan permintaan berupa array JSON yang diteruskan sebagai nilai parameter docs.

Parameter	Tipe	Wajib	Deskripsi
`docs`	List	Ya	Daftar dokumen yang akan didorong.

Setiap objek dokumen dalam daftar docs berisi parameter berikut.

Parameter	Tipe	Wajib	Deskripsi
`cmd`	String	Ya	Operasi yang akan dilakukan. Tetapkan ke `ADD`.
`fields`	Map	Ya	Bidang dokumen. Skema bidang harus sesuai dengan tipe tabel target.

Parameter fields

Nilai fields adalah peta kunci-nilai yang kuncinya harus sesuai dengan skema tabel target. OpenSearch mendukung tiga jenis tabel: tabel pengguna, tabel item, dan tabel perilaku. Untuk definisi bidang masing-masing jenis tabel, lihat Data collection 2.0.

Elemen respons

Parameter	Tipe	Deskripsi
`errors`	List	Detail kesalahan.
`status`	String	Hasil permintaan. Nilai yang valid: `OK` (berhasil), `FAIL` (gagal). Jika permintaan gagal, lakukan pemecahan masalah berdasarkan kode kesalahan.
`request_id`	String	ID permintaan.
`result`	Boolean	Mengembalikan `true` untuk permintaan yang berhasil. Tidak dikembalikan untuk permintaan yang gagal.

Contoh

Permintaan

POST /v3/openapi/app-groups/zhao_special/data-collections/zhao_special/data-collection-type/behavior/actions/bulk

[
  {
    "cmd": "ADD",
    "fields": {
        "sdk_type": "opensearch_sdk",
        "sdk_version": "3.2.0",
        "user_id": "10469628",
        "biz_id": 123,
        "trace_id": "231084198510103333",
        "item_id": "id",
        "item_type": "item",
        "bhv_type": "click",
        "reach_time": "20190730105931"
    }
  }
]

Respons

{
    "errors": [],
    "request_id": "155084740119723291017595",
    "status": "OK",
    "result": true
}