商談へのアクセスと管理を行います。
サポートされている操作
opportunity でサポートされている操作は、create、read、update、delete、undelete、query です。
| create |
- 表示形式
-
- 必須パラメータ
-
user_key、api_key、prospect_email、name、value、probability
- 説明
- 指定されたデータを使用して、新しい商談を作成します。prospect_email パラメータは、既存の見込み客に対応している必要があります。name、value、probability も指定する必要があります。
prospect_email と prospect_id の両方が指定されている場合は、どちらも同じ見込み客に対応している必要があります。
|
| create |
- 表示形式
-
- 必須パラメータ
-
user_key、api_key、prospect_email、name、value、probability
- 説明
- 指定されたデータを使用して、新しい商談を作成します。prospect_id パラメータは、既存の見込み客に対応している必要があります。name、value、probability も指定する必要があります。
|
| update |
- 表示形式
-
- 必須パラメータ
-
user_key、api_key、id
- 説明
-
id (対象商談の Pardot ID) で指定された商談に提供されるデータを更新します。要求によって更新されない項目は変更されません。商談の更新バージョンを返します。
|
| query |
- 表示形式
-
- 必須パラメータ
-
user_key、api_key
- 説明
- 指定された条件パラメータと一致する商談を返します。
|
使用方法
商談データ項目の値を変更するには、更新する項目ごとにパラメータを指定して update 要求を送信します。各パラメータの形式は field_name=value です。
次の例では、Pardot ID が 27 の商談の値を更新します。
要求で特に指示された値のみが更新されます。他のすべての値は変更されません。値をクリアするには、status= のように、指定値のないパラメータを含む update 要求を送信します。
opportunity についての詳細は、Pardot API ドキュメントの「opportunity の使用」および商談項目のリファレンスを参照してください。