接続の確立
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:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
REST、SOAP API はどちらもサポートされており、Schema を使って選択できます。
Marketo REST API に接続
Marketo REST API に接続する前に、カスタムサービスを作成する必要があります。カスタムサービスを作成
カスタムサービスを作成するには、以下の手順に従ってください。
- Marketo アプリケーションの[管理]エリアに移動します。
- [セキュリティ]セクションの[ユーザ&ロール]をクリックしてください。
- [ロール]タブを選択して、[新規ロール]をクリックし、新しいロールを作成してください。
- [ロール名]を入力し、ロールの権限を選択します。[API へのアクセス]権限はREST API 固有です。
- API ロールを作成したら[ユーザ]タブを選択して、[新規ユーザの招待]をクリックしてください。
- 新しいユーザの情報を入力し、先ほど作成した、API に接続可能なロールを選択します。API のみのユーザであることを示すために、[API のみ]オプションを選択することもできます。
- 新しいユーザが作成されたので、新しいサービスを作成します。[LaunchPoint]オプションをクリックしてください([管理]->[統合]->[LaunchPoint])。
- [新規サービス]をクリックしてください。
- [カスタム]サービスタイプを選択し、[表示名]および[詳細]を入力します。
- 作成したユーザを選択します。
OAuth 資格情報を取得
OAuthClientId とOAuthClientSecret を取得するには、[管理]エリアの[LaunchPoint]オプションに移動してください。
お好みのサービスについて、[詳細の表示]リンクをクリックしてください。認証資格情報を含むウィンドウが表示されます。
REST API への認証
カスタムサービスを作成してOAuth 資格情報を取得した後、以下を設定することでデータに接続できます。
- Schema:REST に設定。
- OAuthClientId:カスタムサービスに紐付けられたOAuth クライアントID。
- OAuthClientSecret:カスタムサービスに紐付けられたOAuth クライアントシークレット。
- RESTEndpoint:REST Web サービスエンドポイントのURL。このURL は、Marketo の[管理]エリア内、[統合]->[ウェブ サービス]オプションの[REST API]セクションにあります。
ID は必要ありません。
Marketo SOAP API に接続
SOAP API に接続するには、有効なMarketo 資格情報を渡す必要があります。データへの接続には、以下を設定してください。
- Schema:SOAP に設定。
- UserId:User ID は、Marketo の[管理]内、[統合]->[ウェブ サービス]以下の[SOAP API]パネルにあります。
- EncryptionKey:Marketo SOAP API 暗号化キー。このキーはMarketo Web サイトの[管理]ページで生成されます。
- SOAPEndpoint:Marketo Web サイトの[管理]ページにある、SOAP Web サービスエンドポイントのURL です。