ドキュメントMarketo 開発者ガイド

Marketo オブジェクト

Last update: Tue Aug 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：
  • 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
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59