Marketo Bulk Extract¶
Marketo は、Bulk Extract と呼ばれる、大量の個人および個人関連データを取得するためのインターフェイスを備えています。Marketo Bulk Extract テンプレートでは、以下のエンティティに対するアクセスを構成します。
リード
アクティビティ
プログラム
Bulk Extract を実行するには、ジョブを作成し、取得するデータのセットを定義して、ジョブをキューに入れ、ジョブのファイル書き込み完了を待機して、HTTP 経由でファイルを取得します。 これらのジョブは非同期に実行され、ポーリングされてエクスポートのステータスを取得できます。
アーティファクトのインポート¶
Marketo Bulk Extract ビューを作成するには、 [File] メニュー > [New] > [Data source] をクリックして、[Marketo bulk extract] を選択します。

Marketo Bulk Extract ウィザード¶
以下のパラメータを入力します。
Database: Marketo Bulk Extract ビューが作成されるデータベースの名前。
Client ID: Marketo インスタンスで提供されるクライアント ID。
Client Secret: Marketo インスタンスで提供されるクライアントシークレット。
Scope: API アクセス権限を持つ Marketo ユーザー。
Marketo instance: 使用する Marketo インスタンス。
ここで [Execute import] をクリックして、Marketo にクエリを実行するためのデータソースとビューを作成します。
重要
含まれているストアドプロシージャのセットは、最終ビューで使用され、古いアクセストークンの有効期限が切れたときに、新しいアクセストークンを要求するタスクを担っています。したがって、直接使用できるのは最終ビューだけです。

Marketo Bulk Extract ビュー¶
アクティビティ
create_export_activity_job: Marketo アクティビティをエクスポートするためのジョブを作成します。パラメータ
startat
はジョブの開始時刻、endat
はジョブの終了時刻を指定します。enqueue_export_activity_job: エクスポートジョブをキューに入れます。これにより、エクスポートジョブがキューに配置され、リソースの計算が利用可能になるとジョブを開始します。ジョブは “Created” 状態でなければなりません。
export_activity_file: エクスポートジョブのファイル内容を返します。エクスポートジョブは「Completed」状態でなければなりません。
export_activity_job: 過去 7 日間に作成されたエクスポートジョブのリストを返します。
get_status_export_activity_job: エクスポートジョブのステータスを返します。ジョブのステータスは、Completed または Failed ステータスに達してから 30 日間有効です。
cancel_export_activity_job: エクスポートジョブをキャンセルします。
リード
create_export_lead_job: Marketo リードをエクスポートするためのジョブを作成します。パラメータ
startat
はジョブの開始時刻、endat
はジョブの終了時刻を指定します。create_export_lead_job: エクスポートジョブをキューに入れます。これにより、エクスポートジョブがキューに配置され、リソースの計算が利用可能になるとジョブを開始します。ジョブは “Created” 状態でなければなりません。
export_lead_file: エクスポートジョブのファイル内容を返します。エクスポートジョブは「Completed」状態でなければなりません。
get_export_lead_jobs: 過去 7 日間に作成されたエクスポートジョブのリストを返します。
get_status_export_lead_job: エクスポートジョブのステータスを返します。ジョブのステータスは、Completed または Failed ステータスに達してから 30 日間有効です。
cancel_export_lead_job: エクスポートジョブをキャンセルします。
プログラム
create_export_program_job: Marketo プログラムをエクスポートするためのジョブを作成します。パラメータ
startat
はジョブの開始時刻、endat
はジョブの終了時刻を指定します。enqueue_export_program_job: エクスポートジョブをキューに入れます。これにより、エクスポートジョブがキューに配置され、リソースの計算が利用可能になるとジョブを開始します。ジョブは “Created” 状態でなければなりません。
export_program_file: エクスポートジョブのファイル内容を返します。エクスポートジョブは「Completed」状態でなければなりません。
get_export_program_jobs: 過去 7 日間に作成されたエクスポートジョブのリストを返します。
get_status_export_program_job.: エクスポートジョブのステータスを返します。ジョブのステータスは、Completed または Failed ステータスに達してから 30 日間有効です。
cancel_export_program_job: エクスポートジョブをキャンセルします。
クエリ例¶
作成された Marketo ビューに対してクエリを実行できます。

Marketo の Bulk Extract アクティビティジョブの作成のクエリ¶

Marketo の Bulk Extract アクティビティジョブの作成のクエリ結果¶

Marketo の Bulk Extract アクティビティジョブのキュー配置のクエリ¶

Marketo の Bulk Extract アクティビティジョブのキュー配置のクエリ結果¶

Marketo の Bulk Extract アクティビティジョブのステータス取得のクエリ¶

Marketo の Bulk Extract アクティビティジョブのステータス取得のクエリ結果¶

Marketo の Bulk Extract アクティビティジョブのエクスポートのクエリ¶

Marketo の Bulk Extract アクティビティジョブのエクスポートのクエリ結果¶

Marketo の Bulk Extract アクティビティジョブのファイルのエクスポートのクエリ¶

Marketo の Bulk Extract アクティビティジョブのファイルのエクスポートのクエリ結果¶