この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える
Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords

prospect の使用

見込み客へのアクセスと管理を行います。

サポートされている操作

prospect でサポートされている操作は、assignunassigncreatereadupdateupsertdeletequery です。

操作 説明
assign
表示形式
1/api/prospect/version/3/do/assign/email/email?...
必須パラメータ
user_keyapi_keyemail (user_email または user_id または group_id)
説明
email で指定された見込み客を、指定された Pardot ユーザ/グループに割り当てまたは再割り当てします。対象ユーザ/グループを識別するには、user_emailuser_id、または group_id のいずれか 1 つのパラメータを指定する必要があります。見込み客の更新バージョンを返します。
assign
表示形式
1/api/prospect/version/3/do/assign/id/id?...
必須パラメータ
user_keyapi_keyid (user_email または user_id または group_id)
説明
id で指定された見込み客を、指定された Pardot ユーザ/グループに割り当てまたは再割り当てします。対象ユーザ/グループを識別するには、user_emailuser_id、または group_id のいずれか 1 つのパラメータを指定する必要があります。見込み客の更新バージョンを返します。
create
表示形式
1/api/prospect/version/3/do/create/email/email?...
必須パラメータ
user_keyapi_keyemail
説明
指定されたデータを使用して、新しい見込み客を作成します。email には、一意のメールアドレスを指定する必要があります。この要求に、メールリスト登録およびカスタム項目データを追加することもできます。
query
表示形式
1/api/prospect/version/3/do/query?...
必須パラメータ
user_keyapi_key
説明
指定された条件パラメータと一致する見込み客を返します。
query
表示形式
1/api/opportunity/version/3/do/query?...
必須パラメータ
user_keyapi_key
説明
指定された条件パラメータと一致する商談を返します。

見込み客の割り当てと再割り当て

見込み客の割り当てまたは再割り当てを行うには、割り当てる見込み客と、割り当ての対象ユーザ/グループの両方を定義する必要があります。見込み客は、その Pardot ID またはメールアドレスで指定できます。ユーザまたはグループは、その Pardot ユーザ ID、メールアドレス、または Pardot グループ ID で指定できます。

次の例に、パラメータの可能な組み合わせを示します。[斜体]で示されるパラメータを、特定の値に置き換える必要があります。
1/api/prospect/version/3/do/assign/email/?user_email=user_email
2&api_key=api_key&user_key=user_key
1/api/prospect/version/3/do/assign/email/?user_id=user_id
2&api_key=api_key&user_key=user_key
1/api/prospect/version/3/do/assign/email/?group_id=group_id
2&api_key=api_key&user_key=user_key
1/api/prospect/version/3/do/assign/id/?user_email=user_email
2&api_key=api_key&user_key=user_key
1/api/prospect/version/3/do/assign/id/?user_id=user_id
2&api_key=api_key&user_key=user_key
1/api/prospect/version/3/do/assign/id/?group_id=group_id
2&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&last_name=last_name&api_key=api_key&user_key=user_key

prospect についての詳細は、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&api_key=api_key&user_key=user_key

要求で特に指示された値のみが更新されます。他のすべての値は変更されません。値をクリアするには、phone= のように、指定値のないパラメータを含む update 要求を送信します。

複数の応答を記録するよう設定された項目の場合、この方法では値をクリアできません。

メモ