コンタクトの検索

使用するフィルターのタイプ。フィルターの使用？（Use Filters?）をNoに設定した場合は、-- No Filters --を選択します。それ以外の場合は、次の中から選択します。

• Equal to

• Not equal to

• Less than

• Less than or equal to

• Greater than

• Greater than or equal to

• Has property value

• Does not have property value

• Contains word

• Does not contain word

HubSpot CRMでは、それぞれが最大3つのフィルターを含むことができる、最大3つのフィルターグループを作成できます。

Aliceという名のエントリをチェックするフィルターの例を示します。

{
    "propertyName": "firstname",
    "operator": "EQ",
    "value": "Alice"
}

同様に、プロパティを持つかどうかによってエントリをフィルタリングできます。

{
    "propertyName": "enum1",
    "operator": "HAS_PROPERTY",
}

特定のプロパティを持たないエントリをフィルタリングできます。

{
    "propertyName": "enum2",
    "operator": "NOT_HAS_PROPERTY",
}

フィルターグループ内の複数のエントリは論理AND演算子を使用して組み合わされます。次の例を考察してください。

{
    "propertyName": "associations.company",
    "operator": "EQ",
    "value": "Example"
},
{
    "propertyName": "associations.contact",
    "operator": "EQ",
    "value": "123"
},
{
    "propertyName": "associations.deal",
    "operator": "EQ",
    "value": "456"
}

前述のフィルターグループの結果は、会社がExampleかつコンタクトIDが123かつ取引IDが456であるすべてのエントリに一致します。

複数のフィルターグループがある場合、結果を組み合わせるために論理ORグループ化が使用されます。たとえば、filtergrp1、filtergrp2、filtergrp3という3つのフィルターグループがあるとします。各グループ内のフィルターは、AND演算子を使用して組み合わされます。結果のエントリは、filtergrp1 OR filtergrp2 OR filtergrp3という式を使用してグループを組み合わせることでまとめられます。

また、カードにinput1とinput2という2つの入力プロパティーがあり、filtergrp1という1つのフィルターグループがあるとします。すると結果セットは(input1 AND input2) OR filtergrp1の結果の組み合わせになります。

カスタムフィルターでの使用がサポートされているオブジェクトタイプ、プロパティー、演算子の完全なリストについては、「HubSpot CRM APIの検索」を参照してください。