REST API

Marketo REST APIでは、多くのシステム機能にリモートアクセスできます。 プログラムの作成、リードの一括インポート、Marketoインスタンスの詳細レベルの制御に使用できます。

REST APIは、大きく分けて次のふたつのカテゴリーに分類されます。

標準API呼び出しのURIの最大長は8 KB、最大ボディサイズは1 MBです。 Bulk API呼び出しは、最大10 MBのボディサイズをサポートします。

呼び出しにエラーが含まれている場合、APIは通常、HTTP ステータスコード 200を返します。 JSON応答には、値falseのsuccess メンバーと、errors メンバーのエラーの配列が含まれています。 エラーの詳細については、こちらを参照してください。

はじめに

次の手順を実行するには、Marketo インスタンスの管理者権限が必要です。 このワークフローでは、API資格情報を作成し、それを使用してリードレコードを取得します。

まず、API ユーザーを作成し、認証済み呼び出しの資格情報を取得します。 インスタンスにログインし、管理者 > ユーザーと役割​に移動します。

「役割」タブを選択し、「新しい役割」を選択します。 アクセス API グループから「読み取り専用リード」（または「読み取り専用ユーザー」）権限を少なくとも役割に割り当てます。 役割にわかりやすい名前を付け、作成​を選択します。

​ ユーザー タブに戻り、新規ユーザーの招待​を選択します。 ユーザーをAPI ユーザーとして識別する記述的な名前を入力し、電子メールアドレスを入力して、次へ​を選択します。

「APIのみ」オプションを選択し、作成したAPI役割を割り当て、次へ​を選択します。

送信​を選択してユーザーを作成します。

次に、管理者 メニューに移動し、LaunchPoint​を選択します。

新規 > 新規サービス​を選択します。 わかりやすい名前と説明を入力し、​ サービス ​ メニューから​ カスタム ​を選択します。 APIのみユーザー メニューから新しいユーザーを選択し、作成​を選択します。

新しいサービスの​ 詳細を表示 ​を選択して、クライアント IDとクライアント秘密鍵にアクセスします。 「トークンを取得」を選択して、1時間有効なアクセストークンを生成します。 最初のAPI呼び出しのトークンを保存します。

管理者 > Web サービス​に移動します。

REST API ボックスでEndpointを見つけ、最初のAPI呼び出しのために保存します。

すべてのREST API呼び出しには、HTTP ヘッダーにアクセストークンを含める必要があります。

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int

新しいブラウザータブを開き、次のURLを入力します。 プレースホルダーをインスタンスのエンドポイントとメールアドレスに置き換えて、​ フィルタータイプでリードを取得を呼び出します。

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

データベースに電子メールアドレスを持つリードレコードが含まれていない場合は、既存のリードの電子メールアドレスを使用します。 URLを送信して、次の例のような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使用状況を特定できます。

呼び出しがインスタンスの制限を超え、その後の呼び出しが失敗した場合は、レポートを使用して各サービスの呼び出し量を特定します。 管理者 > 統合 > Web サービス​に移動し、過去7日間に行われた呼び出しの数を選択します。

毎日および過去7日間の使用状況とエラーの統計を返すREST エンドポイントについては、使用状況を参照してください。