Menyiapkan filter pelanggan menggunakan ListCustomers API

Jika perlu menemukan informasi tentang pelanggan tertentu, Anda dapat menggunakan parameter filter Cloud Channel API melalui metode customers.list.

Jika Anda menggunakan filter, ada penundaan singkat (biasanya beberapa detik) selama pembuatan pelanggan. Jika Anda memerlukan akses ke pelanggan segera setelah pembuatannya, sebaiknya gunakan customers.list tanpa filter atau customers.get.

Filter yang tersedia

String untuk parameter filter mendukung pencocokan persis, atau pencocokan persis dan pemfilteran awal. Filter tidak peka huruf besar/kecil.

Tabel berikut menjelaskan kolom yang tersedia yang dapat Anda telusuri, dan metode yang didukungnya.

Tombol Penelusuran Eksternal	Dukungan pencocokan persis	Dukungan awalan
domain	Ya	Ya
org_display_name	Ya	Ya
cloud_identity_id	Ya	Tidak
channel_partner_id	Ya	Tidak

Anda dapat menemukan sintaksis filter lengkap di panduan pemfilteran API.

Sintaksis pencocokan persis

Filter pencocokan persis hanya akan menemukan pelanggan yang berisi kolom yang sama dengan yang ada di string yang dikirimkan.

Sintaksis: <domain | org_display_name | cloud_identity_id | channel_partner_id> = <value>

Contoh: domain = "domain.com" AND channel_partner_id = "12345"

Sintaksis awalan

Filter awalan memungkinkan penggunaan tanda bintang sebagai simbol karakter pengganti. Filter ini akan menemukan pelanggan yang memiliki kolom dengan awalan, apa pun konten yang muncul setelahnya.

Sintaksis: <domain | org_display_name> : <value>*

Contoh: domain : "uw.com*" AND org_display_name : "prefix*"

Contoh filter dengan operator logis

Filter Cloud Channel API mendukung penggunaan operator logika DAN dan ATAU. Anda dapat menggunakan kedua operator tersebut dalam satu filter dengan menggunakan pernyataan tanda kurung.

Contoh AND

domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name : "display*"

Contoh OR

domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name : "display*"

Contoh AND + OR

domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name : "display*" )

Anda harus menggunakan tanda kurung jika filter berisi pernyataan AND dan OR. Contoh berikut bukan string filter yang valid.

domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name : "display*