Salesforce1 Platform API サービスガイド
jprospect の使用
見込み客へのアクセスと管理を行います。
サポートされている操作
prospect でサポートされている操作は、assign、unassign、create、read、update、upsert、delete、query です。
| 操作 | 説明 |
|---|---|
| assign |
|
| assign |
|
| create |
|
| query |
|
| query |
|
見込み客の割り当てと再割り当て
見込み客の割り当てまたは再割り当てを行うには、割り当てる見込み客と、割り当ての対象ユーザ/グループの両方を定義する必要があります。見込み客は、その Pardot ID またはメールアドレスで指定できます。ユーザまたはグループは、その Pardot ユーザ ID、メールアドレス、または Pardot グループ ID で指定できます。
次の例に、パラメータの可能な組み合わせを示します。[斜体]で示されるパラメータを、特定の値に置き換える必要があります。
1/api/prospect/version/3/do/assign/email/?user_email=user_email
2
3&api_key=api_key&user_key=user_key1/api/prospect/version/3/do/assign/email/?user_id=user_id
2
3&api_key=api_key&user_key=user_key1/api/prospect/version/3/do/assign/email/?group_id=group_id
2
3&api_key=api_key&user_key=user_key1/api/prospect/version/3/do/assign/id/?user_email=user_email
2
3&api_key=api_key&user_key=user_key1/api/prospect/version/3/do/assign/id/?user_id=user_id
2
3&api_key=api_key&user_key=user_key1/api/prospect/version/3/do/assign/id/?group_id=group_id
2
3&api_key=api_key&user_key=user_key要求で特に指示された値のみが更新されます。他のすべての値は変更されません。値をクリアするには、status= のように、指定値のないパラメータを含む update 要求を送信します。
見込み客の作成
API を使用して見込み客を作成する場合は、有効かつ一意のメールアドレスのみが必要です。create 要求で、他の見込み客項目の値を指定することもできます。開発者は、italics で示されるパラメータを特定の値に置き換える必要があります。
次の例に、新しい見込み客を作成する方法を示します。
1/api/prospect/version/3/do/create/email/new_prospect@pardot.com?first_name=first_name
2
3&last_name=last_name&api_key=api_key&user_key=user_keyprospect についての詳細は、Pardot API ドキュメントの「prospect の使用」および見込み客項目のリファレンスを参照してください。
項目値の更新
見込み客データ項目の値を変更するには、更新する項目ごとにパラメータを指定して update 要求を送信します。各パラメータの形式は field_name=value です。カスタム項目値の更新にも、同じ構文が使用されます。
次の例に、メールアドレスが bob@pardot.com の見込み客の電話番号を更新する方法を示します。
1/api/prospect/version/3/do/update/email/bob@pardot.com?phone=888-123-4567
2
3&api_key=api_key&user_key=user_key要求で特に指示された値のみが更新されます。他のすべての値は変更されません。値をクリアするには、phone= のように、指定値のないパラメータを含む update 要求を送信します。