Jika perlu menemukan informasi tentang pelanggan tertentu, Anda dapat menggunakan
parameter filter Cloud Channel API melalui
metode customers.list.
Jika Anda menggunakan filter, akan ada penundaan singkat (biasanya beberapa detik) selama pembuatan pelanggan. Jika Anda memerlukan akses ke pelanggan segera setelah
pembuatan, sebaiknya gunakan customers.list tanpa filter atau
customers.get.
Filter yang tersedia
String untuk parameter filter mendukung pencocokan persis, atau pencocokan persis plus pemfilteran awalan. Filter tidak peka huruf besar/kecil.
Tabel berikut menjelaskan kolom yang tersedia yang dapat Anda telusuri, dan metode yang didukungnya.
| Kunci 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 kolom dalam 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, terlepas dari konten yang ada setelahnya.
Sintaksis: <domain | org_display_name> : <value>*
Contoh: domain : "uw.com*" AND org_display_name : "prefix*"
Contoh filter dengan operator logika
Filter Cloud Channel API mendukung penggunaan operator logika DAN dan ATAU. Anda dapat menggunakan kedua operator dalam satu filter menggunakan pernyataan tanda kurung.
Contoh DAN
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 DAN + ATAU
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
Anda perlu 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*