您位於此處:
InsCensusServiceStd:findContacts
依名字、姓氏和電子郵件搜尋現有連絡人,或依搜尋索引鍵和群組帳戶搜尋。
類別:InsCensusServiceStd
方法:findContacts
運作方式
-
如果服務要求裝載包含具有名字、姓氏、電子郵件地址和群組帳戶的成員陣列:
-
此服務會查詢「連絡人」實體,並且取用所有具有相符名字和/或姓氏和/或電子郵件地址和帳戶的連絡人。
-
所有相符的連絡人識別碼、名字、姓氏和電子郵件都會新增至回應中的「連絡人」節點清單。
-
-
如果服務要求裝載包含 searchKey 和群組帳戶:
-
如果指定的搜尋索引鍵包含單一字,則服務會查詢「連絡人」實體,並取回具有部分/完全相符名稱和帳戶的所有連絡人。名稱開頭為指定的搜尋字詞支援部分比對。
-
如果指定的搜尋金鑰包含一個以上的字:
-
此服務只會考量「連絡人」搜尋的前兩個字 (以空格分隔),並忽略搜尋索引鍵中的其餘字。
-
此服務會查詢「連絡人」實體,然後使用 (名字以搜尋索引鍵的第一個字開頭,姓氏以搜尋索引鍵的第二個字開頭) 或 (名字以第二個字開頭,姓氏以搜尋索引鍵的第一個字開頭) 和帳戶,來取用所有連絡人。
-
-
所有相符的連絡人識別碼、名字、姓氏和電子郵件都會新增至回應中的「連絡人」節點清單。
-
輸入
| 輸入 | 描述 |
|---|---|
accountId
|
必要 連絡人的 GroupAccountId。 |
searchKey
|
如果未使用成員,則為必要。 一或多個字詞用於搜尋包含搜尋關鍵字的連絡人名稱。 |
members
|
如果未使用 searchKey,則為必要。 要在連絡人中搜尋的成員清單。 |
| 成員節點 | |
FirstName
|
名字 |
LastName
|
姓氏 |
Email
|
|
遠端選項
| 選項 | 描述 |
|---|---|
accountId
|
必要。 連絡人的 GroupAccountId。 |
searchKey
|
如果未使用成員,則為必要。 一或多個字詞用於搜尋包含搜尋關鍵字的連絡人名稱。 |
members
|
如果未使用 searchKey,則為必要。 要在連絡人中搜尋的成員清單。 |
| 成員節點 | |
FirstName
|
名字 |
LastName
|
姓氏 |
Email
|
|
輸入 JSON
以下是範例輸入 JSON:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
輸出 JSON
以下是範例輸出 JSON:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }