Marketo オブジェクト
最終更新日: 2025年5月14日
- トピック:
- SOAP
作成対象:
- 管理者
Marketo は、Marketo オブジェクト(MObject)を使用して、Program、Opportunity、OpportunityPersonRole などの様々なクラスを表します。
MObject の構造
MObject には、標準、カスタム、仮想の 3 つのタイプのいずれかを指定できます。標準およびカスタム MObject は、Lead や Company などの個別のエンティティを表しますが、LeadRecord などの仮想オブジェクトは、1 つ以上のオブジェクトのフィールドで構成されます。仮想オブジェクトは、API 内で使用される便利なオブジェクトですが、Marketo アプリケーション内には存在しません。
MObject は、次で構成されます。
-
すべての MObject に共通する固定属性の小さなセット
- 必須タイプ
- オプションの externalKey
- 読み取り専用 ID、createdAt、updatedAt
-
名前と値のペアとして 1 つ以上のオブジェクト固有の属性のリスト。一部の属性は必須になる場合があります。例:Opportunity での名前。
-
関連するオブジェクト参照のリスト。オブジェクト名と、次のいずれかが含まれます。
- Marketo ID または
- 属性名/属性値のペアとしての外部キー。
外部キー
外部キーは、Lead や Opportunity などの Marketo オブジェクトで定義されたカスタムフィールドです。名前はフィールド名で、値は外部システムで生成されたフィールド値です。Marketo では、これらの値に対して一意の制約を適用しません。 値が一意であることを確認するのは API ユーザの責任です。重複が発生した場合、Marketo では最後に追加されたオブジェクトを使用します。これは、「メールアドレス」標準フィールドの動作に似ています。
使用可能な API
API | 次で操作可能 |
---|---|
describeMObject | ActivityRecord、LeadRecord、Opportunity、OpportunityPersonRole |
getMObjects | Opportunity、OpportunityPersonRole、Program |
syncMObjects | Opportunity、OpportunityPersonRole、Program |
deleteMObjects | Opportunity、OpportunityPersonRole |
listMObjects | ActivityRecord、LeadRecord、Opportunity、OpportunityPersonRole |