ドキュメント“Marketo デベロッパーガイド"

REST API

Last update: Mon Nov 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 管理者

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

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

  • 毎日の割り当て量： 購読には、1 日あたり 50,000 回の API 呼び出しが割り当てられます（毎日午前 0 時（CST）にリセットされます）。 アカウントマネージャーを通じて、1 日の割り当て量を増やすことができます。
  • レート制限：インスタンスあたりの API アクセスは、20 秒あたり 100 呼び出しに制限されています。
  • 同時実行制限：  最大 10 回の同時 API 呼び出し。

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

はじめに

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

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

管理者ユーザーと役割

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

新しい役割

ここで、「​ ユーザー ​」タブに戻り、「新規ユーザーを招待」をクリックします。 ユーザーに API ユーザーであることを示すわかりやすい名前とメールアドレスを指定し、「次へ」をクリックします。

新規ユーザー情報

次に、「API のみ ​」オプションをオンにし、作成した API の役割をユーザーに付与し、「次へ」をクリックします。

新規ユーザー権限

ユーザー作成プロセスを完了するには、「送信」をクリックします。

新規ユーザーメッセージ

次に、​ 管理者 ​ メニューに移動し、LaunchPoint をクリックします。

ローンチポイント

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

新しい起動ポイント サービス

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

トークンを取得

次に、管理者 メニューに移動し、次に web サービス に移動します。

Web サービス

REST API ボックスで ​ エンドポイント ​ を見つけて、今はメモに保存します。

REST エンドポイント

REST API メソッドを呼び出す場合は、呼び出しを正常に実行するために、すべての呼び出しにアクセストークンを含める必要があります。 アクセストークンは HTTP ヘッダーとして送信する必要があります。

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
IMPORTANT
access_token クエリパラメーターを使用した認証のサポートは、2025 年 6 月 30 日（PT）に削除されます。 プロジェクトでクエリパラメーターを使用してアクセストークンを渡す場合は、できるだけ早く Authorization ヘッダーを使用するように更新する必要があります。 新しい開発では、Authorization ヘッダーのみを使用する必要があります。

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

<Your Endpoint URL>/rest/v1/leads.json?&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 呼び出し数が制限を超え、以降の呼び出しが失敗した場合は、この方法を使用すると、各サービスのボリュームを考慮して、問題の解決方法を評価できます。 管理者/統合/web サービス に移動し、過去 7 日間の呼び出し数をクリックして、使用状況を確認します。

recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59