接続の確立

コネクタ内で利用可能なオブジェクトは、"cdata.marketo" モジュールからアクセスできます。モジュールのオブジェクトを直接使用するには：

モジュールを以下のようにインポートします。
```
import cdata.marketo as mod
```
接続を確立するには、以下のような適切な接続文字列を使用してコネクタオブジェクトからconnect() メソッドを呼び出します。
```
mod.connect("Schema=REST;RESTEndpoint=https://MyMarketoUrl/rest;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;")
```

Marketo への接続

Marketo は2つのAPI を提供しています。REST およびSOAP です。使用するAPI を指定するには、 Schema プロパティをREST またはSOAP のいずれかに設定します。

REST API は、OAuth 認証を使用してユーザーのアクセスを検証します。REST API 経由の Marketo へのアクセスを設定するには：

この手順では、REST API 権限を持つ新しいロールを作成し、そのロールを既存または新規のユーザーに割り当て、新しいサービスを作成します。これは管理者権限を持つユーザーによって実行される必要があります。

Marketo アプリケーションの［管理］エリアに移動します。
［セキュリティ］セクションに移動します。
ユーザ& ロールをクリックします。
API アクセス用の新しいロールを作成します。
1. ロールタブを選択します。
2. 新規ロールをクリックします。
3. ［ロール名］を指定し、ロールの権限を選択します。REST API に固有の［API へのアクセス］権限を指定します。
API アクセスを実行するユーザーを割り当てるか、新規作成します。
1. ユーザタブを選択します。
2. 作成したロールを新規ユーザーに割り当てるには、新規ユーザの招待をクリックします。
3. 新しいユーザーの情報を入力し、先ほど作成した、REST API に接続可能なロールを割り当てます。API 専用ユーザーとして指定するには、API のみオプションを選択します。
新しいサービスを作成します。
1. 管理 -> 統合に移動して、LaunchPoint オプションをクリックします。
2. 新規サービスをクリックします。
3. サービスタイプをカスタムに指定します。
4. サービスの［表示名］および［詳細］を入力します。
5. 作成したユーザーをサービスに割り当てます。

Marketo は、Marketo への接続および認証ために設計された新しいREST API サービスを作成します。また、REST API へのユーザーのアクセスを検証するために必要な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 経由での接続準備は完了です。