接続の確立
接続プロファイルの設定
[CData]リボンから[データの取得]をクリックし、[取得元:Marketo]> 設定済みの接続 を選択して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。
接続プロパティ
最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。
接続の管理
Marketo への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理 を参照してください。
関連項目
- データのクエリ:[データ選択]ウィザードを使用してスプレッドシートにデータをプルします。また、ここではスケジュールされたデータのリフレッシュも設定できます。
- Excel アドインの使用:利用可能なCData Excel 関数 を使用するなど、Marketo データとやり取りする他の方法が見つかります。