USER MANUALS

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 wizard

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 views

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 create bulk extract Activity job query

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

Marketo create bulk extract Activity job query result

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

Marketo enqueue bulk extract Activity job query

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

Marketo enqueue bulk extract Activity job query result

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

Marketo get status bulk extract Activity job query

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

Marketo get status bulk extract Activity job query query result

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

Marketo export bulk extract Activity job query

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

Marketo export bulk extract Activity job query result

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

Marketo export bulk extract Activity job file query

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

Marketo export bulk extract Activity job file query result

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

Add feedback