前提条件
OAuth 認証情報を取得する前に、Marketo にカスタムサービスがない場合は作成する必要があります。この手順では、REST API 権限を持つ新しいロールを作成し、そのロールを既存または新規のユーザーに割り当て、新しいサービスを作成します。 カスタムサービスを作成できるのは Admin 権限を持つユーザーのみです。「サービス」とは、API アクセス用の OAuth 認証情報を提供するために作成されるエンティティを指します。 ステップ 1:API アクセス用の新しいロールを作成する1
Marketo アプリケーションの Admin エリアに移動します。
2
Security セクションに移動します。
3
Users & Roles をクリックします。
4
Roles タブを選択します。
5
New Role をクリックします。
6
ロール名を指定し、ロールの権限を選択します。REST API に固有の Access API 権限を指定します。
1
Users タブを選択します。
2
ロールをユーザーに割り当てるには、Invite New User をクリックします。
3
新規ユーザーの情報を入力し、先ほど作成した REST API アクセス権を持つロールを割り当てます。
4
ユーザーを API 専用ユーザーとして指定するには、API Only オプションを選択します。
1
Admin > Integration に移動し、LaunchPoint オプションをクリックします。
2
New Service をクリックします。
3
Service Type を Custom に指定します。
4
サービスの表示名と説明を入力します。
5
先ほど作成したユーザーをサービスに割り当てます。
1
Admin タブに移動します。
2
LaunchPoint オプションをクリックします。
3
カスタムサービスを選択し、View Details をクリックします。Marketo に認証情報を示すウィンドウが表示されます。
4
Client Id をコピーして OAuthClientId に、Client Secret を OAuthClientSecret に貼り付けます。
セットアップガイド
以下の手順で、Marketo をConnect AI アカウントに接続します:1
Connect AI のナビゲーションメニューからSources ページを開きます。
2
右上の + Add Connection をクリックします。
3
検索フィールドに Marketo と入力し、データソース名をクリックします。
4
新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
5
Marketo の URL を入力します。これは Admin > Integration > Web Services > REST API で確認できます。例: https://123-abc-456.mktorest.com/ または https://123-abc-456.mktorest.com/rest 。
6
前提条件で取得した OAuth Client Id を貼り付けます。
7
前提条件で取得した OAuth Client Secret を貼り付けます。
8
(オプション)特定の大規模データセットの一括リクエストを処理させるには、Use Bulk API を True に設定します。
9
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。