接続の確立
JDBC データソースの作成
Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for Marketo に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。
- ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの[lib]サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
- ドライバークラスを入力します。次に例を示します。
cdata.jdbc.marketo.MarketoDriver
- JDBC URL を入力します。次に例を示します。
jdbc:marketo:Schema=REST;RESTEndpoint=https://MyMarketoUrl/rest;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret; or jdbc:cdata:marketo:Schema=REST;RESTEndpoint=https://MyMarketoUrl/rest;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:marketo:" または"jdbc:cdata:marketo:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
Marketo への接続
Marketo は2つのAPI を提供しています。REST およびSOAP です。使用するAPI を指定するには、 Schema プロパティをREST またはSOAP のいずれかに設定します。
REST API
REST API は、OAuth 認証を使用してユーザーのアクセスを検証します。REST API 経由の Marketo へのアクセスを設定するには:- カスタムサービスを作成します。
- 適切なOAuth 認証情報を取得します。
- 接続変数を設定します。
カスタムサービスの作成
この手順では、REST API 権限を持つ新しいロールを作成し、そのロールを既存または新規のユーザーに割り当て、新しいサービスを作成します。これは管理者権限を持つユーザーによって実行される必要があります。- Marketo アプリケーションの[管理]エリアに移動します。
- [セキュリティ]セクションに移動します。
- ユーザ& ロールをクリックします。
- API アクセス用の新しいロールを作成します。
- ロールタブを選択します。
- 新規ロールをクリックします。
- [ロール名]を指定し、ロールの権限を選択します。REST API に固有の[API へのアクセス]権限を指定します。
- API アクセスを実行するユーザーを割り当てるか、新規作成します。
- ユーザタブを選択します。
- 作成したロールを新規ユーザーに割り当てるには、新規ユーザの招待をクリックします。
- 新しいユーザーの情報を入力し、先ほど作成した、REST API に接続可能なロールを割り当てます。API 専用ユーザーとして指定するには、API のみオプションを選択します。
- 新しいサービスを作成します。
- 管理 -> 統合に移動して、LaunchPoint オプションをクリックします。
- 新規サービスをクリックします。
- サービスタイプをカスタムに指定します。
- サービスの[表示名]および[詳細]を入力します。
- 作成したユーザーをサービスに割り当てます。
Marketo は、Marketo への接続および認証ために設計された新しいREST API サービスを作成します。 また、REST API へのユーザーのアクセスを検証するために必要なOAuth ベースの認証情報も生成します。
OAuth 資格情報を取得
新しいサービスのOAuth 資格情報を取得して記録するには、Marketo [管理]エリアに戻り、 LaunchPoint オプションに移動します。
作成したサービスの詳細の表示リンクをクリックします。Marketo は、認証資格情報を表示するウィンドウを開きます。 これらの資格情報は、OAuthClientId およびOAuthClientSecret の値を提示します。
接続変数の設定
以下の接続変数を設定したら、REST API 経由での接続準備は完了です。- Schema:REST。
- OAuthClientId:カスタムサービスに紐付けられたOAuth クライアントID。
- OAuthClientSecret:カスタムサービスに紐付けられたOAuth クライアントシークレット。
- RESTEndpoint:管理エリアにある、REST Web サービスエンドポイントのURL。 REST API の統合 -> ウェブ サービスセクションに移動して、このURL を見つけます。 Identity Endpoint は空白のままにします。
SOAP API
以下の接続変数を設定したら、SOAP API 経由での接続準備は完了です。- Schema:SOAP。
- UserId:Marketo の[管理]SOAP API パネルの統合セクションにあるクライアントアクセスID。
- EncryptionKey:Marketo Web サイトの[管理]ページで生成される、Marketo SOAP API 暗号化キー。
- SOAPEndpoint:Marketo Web サイトの[管理]ページにある、SOAP Web サービスエンドポイントのURL。