REST API

Marketoは、システムの機能の多くをリモートで実行できる REST API を公開しています。 プログラムの作成からリードの一括読み込みまで、Marketo インスタンスの詳細な制御を可能にするオプションが多数あります。

これらの API は、通常、次の 2 つの大きなカテゴリに分類されます。 リードデータベース、および アセット. Lead Database API を使用すると、Marketoの人物レコードおよび関連するオブジェクトタイプ（商談や会社など）の取得とやり取りをおこなうことができます。 Asset API を使用すると、マーケティング用販促物やワークフロー関連のレコードを操作できます。

標準呼び出しのサイズは、URI の長さが 8 KB、本文のサイズが 1 MB に制限されていますが、バルク API の本文は 10 MB にすることができます。 呼び出しでエラーが発生した場合、API は通常、ステータスコード 200 を返しますが、JSON 応答には、値がの「success」メンバーが含まれます false、および「errors」メンバーのエラーの配列。 エラーの詳細 こちら.

はじめに

次の手順では、Marketo インスタンスでの管理者権限が必要です。

Marketoへの最初の呼び出しでは、リードレコードを取得します。 Marketoの使用を開始するには、インスタンスに対して認証済み呼び出しを行うための API 資格情報を取得する必要があります。 インスタンスにログインし、に移動します Admin -> ユーザーと役割.

「」をクリックします 役割 タブに続いて「新しい役割」をクリックし、「読み取り専用リード」（または「読み取り専用ユーザー」）以上の権限をアクセス API グループの役割に割り当てます。 必ずわかりやすい名前を付けて、 作成.

次に、 ユーザー tab キーを押してクリック 新しいユーザーを招待. ユーザーに、API ユーザーであることを示すわかりやすい名前とメールアドレスを指定し、 次.

次に、 API のみ 作成した API の役割をユーザーに付与し、クリックします 次.

ユーザー作成プロセスを完了するには、 送信.

次に、に移動します Admin メニューとクリック LaunchPoint.

「」をクリックします 新規 メニューと選択 新しいサービス. サービスにわかりやすい名前を付け、を選択します。 カスタム から サービス ドロップダウンメニュー。 説明を付けてから、新しいユーザーを API のみのユーザー ドロップダウンメニューとクリック 作成.

クリック 詳細を表示 新しいサービスでクライアント ID とクライアント秘密鍵にアクセスできるようにします。 今のところ、をクリックできます トークンを取得 1 時間有効なアクセストークンを生成するボタン。 現時点では、トークンをメモに保存します。

次に、に移動します  Admin メニュー、次に Web サービス.

の検索 エンドポイント 今は、「REST API」ボックスにメモを保存します。

新しいブラウザータブを開き、適切な情報を使用して以下を入力して呼び出します フィルタータイプ別のリードの取得:

<Your Endpoint URL>/rest/v1/leads.json?access_token=<Your Access Token>&filterType=email&filterValues=<Your Email Address>

データベースにメールアドレスを含むリードレコードがない場合は、存在することが分かっているメールアドレスに置き換えます。 URL バーで Enter キーを押すと、次のような JSON 応答が返されます。

{
    "requestId":"c493#1511ca2b184",
    "result":[
       {
           "id":1,
           "updatedAt":"2015-08-24T20:17:23Z",
           "lastName":"Elkington",
           "email":"developerfeedback@marketo.com",
           "createdAt":"2013-02-19T23:17:04Z",
           "firstName":"Kenneth"
        }
    ],
    "success":true
}

API 使用量

各 API ユーザーは API 使用状況レポートで個別にレポートされるので、ユーザーごとに web サービスを分割すると、各統合の使用状況を簡単に説明できます。 インスタンスへの API 呼び出し数が制限を超え、以降の呼び出しが失敗した場合は、この方法を使用すると、各サービスのボリュームを考慮して、問題の解決方法を評価できます。 に移動して、使用状況を確認します。 Admin -> 統合 > Web サービス 過去 7 日間の通話数をクリックします。