אם אתם צריכים למצוא מידע על לקוח ספציפי, אתם יכולים להשתמש בפרמטר filter של Cloud Channel API באמצעות customers.list method.
אם משתמשים במסנן, יש עיכוב קצר (בדרך כלל כמה שניות) במהלך יצירת הלקוח. אם אתם צריכים לגשת ללקוח מיד אחרי היצירה שלו, מומלץ להשתמש ב-customers.list ללא מסנן או ב-customers.get.
מסננים זמינים
מחרוזות לפרמטר המסנן תומכות בהתאמה מדויקת או בסינון של התאמה מדויקת בתוספת קידומת. המסננים לא תלויי אותיות רישיות.
בטבלה הבאה מתוארים השדות הזמינים שאפשר לחפש בהם, והשיטות שהם תומכים בהן.
| מפתח חיפוש חיצוני | תמיכה בהתאמה מדויקת | תמיכה בקידומות |
|---|---|---|
| דומיין | כן | כן |
| org_display_name | כן | כן |
| cloud_identity_id | כן | לא |
| channel_partner_id | כן | לא |
את התחביר המלא של המסננים אפשר למצוא במדריך לסינון API.
תחביר של התאמה מדויקת
מסננים של התאמה מדויקת ימצאו רק לקוחות שמכילים את אותם שדות כמו אלה במחרוזת שנשלחה.
תחביר:
<domain | org_display_name | cloud_identity_id | channel_partner_id> = <value>
לדוגמה: domain = "domain.com" AND channel_partner_id = "12345"
תחביר הקידומת
מסנני קידומות מאפשרים להשתמש בכוכבית כתו כללי לחיפוש. המסנן הזה ימצא לקוחות שיש להם שדות עם הקידומת, ללא קשר לתוכן שמגיע אחריה.
תחביר: <domain | org_display_name> : <value>*
לדוגמה: domain : "uw.com*" AND org_display_name : "prefix*"
דוגמאות למסננים עם אופרטורים לוגיים
מסנני Cloud Channel API תומכים בשימוש באופרטורים הלוגיים AND ו-OR. אפשר להשתמש בשני האופרטורים במסנן אחד באמצעות הצהרה בסוגריים.
דוגמה לשימוש ב-AND
domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name :
"display*"
דוגמה לשימוש ב-OR
domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name :
"display*"
דוגמה לשימוש ב-AND + OR
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
אם המסנן מכיל הצהרת AND ו-OR, צריך להשתמש בסוגריים. הדוגמה הבאה היא לא מחרוזת מסנן תקינה.
domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name :
"display*