Windows DSN の構成

Microsoft ［ODBC データソースアドミニストレーター］の使用

Microsoft ODBC データソースアドミニストレーターを使ってDSN 設定を編集できます。DSN はインストールプロセス中に作成されることに注意してください。

DSN 設定を編集するには、次の手順を実行してください。

スタート -> 検索 を選択し、検索ボックスにODBC データソース と入力します。
アプリケーションのビット数（32-bit または64-bit）に対応するODBC アドミニストレーターのバージョンを選択してください。
システムDSN タブをクリックします。
システムデータソースを選択して構成をクリックします。
接続タブの情報を編集してOK をクリックします。

Note： .NET Framework 4.0 の場合、本製品はMicrosoft Visual C++ 2015-2022 再頒布可能パッケージを配布します。.NET Framework 3.5 の場合、本製品はMicrosoft Visual C++ 2008 再頒布可能パッケージを配布します。

レジストリへのアクセスの確保

本製品は、接続情報をWindows レジストリに保存します。本製品がレジストリに書き込みできるようにするには、以下のいずれかの操作を実行します。

呼び出すアプリケーションを管理者として実行する。
システムDSN 経由ではなく、ユーザーDSN 経由で接続する。

Amazon Marketplace への接続

Amazon MWS API とSelling Partner API の比較

Amazon MWS (Marketplace Web Services) API は以前からあるAmazon Marketplace のAPI であり、Selling Partner (SP) API は、JSON ベースのREST API 設計基準やOAuth 2.0 など、MWS API と比べて多くの改良点があります。SP-API は、Amazon MWS API で利用可能なすべての機能を含みます。

どちらのAPI を接続に使用するかは、Schema で指定できます。それぞれのAPI で、次に説明する異なる接続オプションを利用可能です。

Selling Partner API への接続

Amazon Selling Partner API を使用してAmazon Marketplace に接続する場合、以下のプロパティが必要です。

Schema：SellingPartner に設定。
InitiateOAuth：GETANDREFRESH に設定。
Marketplace：販売登録されているマーケットプレイスのリージョンに設定。

また、SellingPartner プロパティを使用してSeller またはVendor 認証を選択することができます。

MWS API への接続

Amazon MWS API を使用してAmazon Marketplace に接続する場合、接続プロパティとしてSellerId、Marketplace、Marketplace が必要です。Schema をMarketplace に設定します。

Amazon Marketplace へのアクセスの設定

Amazon Marketplace に接続するには、はじめにCData デベロッパーを認可します。認可するには、次の手順に従ってください。

CData MWS の開発者ID：195280669143 を使用します。
セラーセントラルのアプリを管理ページに移動し、プライマリアカウントホルダーとしてAmazon セラーアカウントにログインします。
新しい開発者を認証するボタンをクリックし、本製品から提供された開発者ID を使用して認可ワークフローに従います。

または、 Amazon Marketplace CData Driver に移動して右パネルの今すぐ承認をクリックします。

MWS 認証トークンの取得

MWS 認証トークンを取得する方法は次のとおりです。

セラーセントラルのアプリを管理ページに移動し、プライマリアカウントホルダーとしてAmazon セラーアカウントにログインします。
CData アプリを見つけます。
MWS 認証トークンカラムの下で表示をクリックします。

出品者ID の取得

下記の手順に従って、出品者ID を取得します。

セラーアカウントにログインします。
設定を選択し、画面右上の出品用アカウント情報を選択します。
出品者情報の下で「あなたの出品者トークン」を選択します。

Amazon Marketplace への認証

Amazon マーケットプレイスアカウント

次の接続プロパティを設定して接続します。

SellerId：Amazon マーケットプレイスWeb サービス設定の出品者ID を設定。
Marketplace：Amazon マーケットプレイスのロケーション（例：United States）に設定。
Schema：Schema をMarketplace に設定。

OAuth

Amazon Marketplace はOAuth 認証標準を利用しています。

OAuth で認証するには、組み込みアプリケーションを使用するか、新しいカスタムOAuth アプリを作成する必要があります。組み込みアプリケーションは、デスクトップアプリケーションおよびヘッドレスマシンをサポートします。Web アプリケーションでは、カスタムOAuth アプリケーションを作成する必要があります。

カスタムOAuth アプリケーションを使用して、サービスアカウントまたはユーザーアカウントで認証できます。詳しくは、カスタムOAuth アプリの作成を参照してください。

埋め込みクレデンシャルのダウンロード

Amazon Marketplace は埋め込みクレデンシャルを6ヶ月ごとに入れ替える必要があるため、CData のクレデンシャルはoa.cdata.com でホストされます。カスタムクレデンシャルを指定しない場合、CData のWeb サービスから埋め込みクレデンシャルがダウンロードされ、デフォルトでOAuthClientLocation で指定した場所に保存されます。 NOTE：ファイアウォールがoa.cdata.com をブロックしないことを確認してください。

デスクトップアプリ

組み込みアプリケーションを使用するか、カスタムOAuth アプリケーションを作成することが可能です。主要な違いは、カスタムアプリケーションを使用する場合は追加の接続プロパティを設定する必要があることです。

OAuth アクセストークンの取得およびリフレッシュ

以下を設定して、接続してください。

Marketplace：販売登録されているマーケットプレイスのリージョンに設定。
AppId：作成したSelling Partner アプリケーションのアプリケーションId に設定。
Schema：SP-API に接続するにはSellingPartner に設定。
AWSAccessKey：OAuthClientId に関連するAWS ユーザーに紐づくアクセスキー。
AWSSecretKey：OAuthClientId に関連するAWS ユーザーに紐づくシークレットキー。
OAuthClientId（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントシークレットに設定。

接続すると、本製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

ヘッドレスマシン

ドライバーを設定するため、ヘッドレスマシンでユーザーアカウントにOAuth を使用します。ユーザーアカウントまたはサービスアカウントを使って、インターネットブラウザに対応した別の端末で認証する必要があります。

以下の2つのオプションから選択します。
- オプション1：後述の「Verifier code を取得および交換」に従い、OAuthVerifier 値を取得します。
- オプション2：別のマシンに本製品をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。
その後、ヘッドレスマシンからアクセストークンを自動的にリフレッシュするように本製品を設定します。

オプション1：Verifier code を取得および交換

別のマシンから認証してOAuthVerifier 接続プロパティを取得するには、次の手順を実行してください。

以下のオプションから選択します。
- 埋め込みOAuth アプリケーションを使用する場合は、GetOAuthAuthorizationURL ストアドプロシージャを呼び出します。ストアドプロシージャによって返されたURL をブラウザで開きます。
- カスタムOAuth アプリケーションを使用するには、以下のプロパティを設定します。
  - InitiateOAuth：OFF に設定。
  - OAuthClientId（カスタムアプリのみ）：アプリケーション設定のクライアントId に設定。
  - OAuthClientSecret（カスタムアプリのみ）：アプリケーション設定のクライアントシークレットに設定。
    次に、適切なCallbackURL を指定してGetOAuthAuthorizationURL ストアドプロシージャを呼び出します。ストアドプロシージャによって返されたURL をブラウザで開きます。
ログインして、本製品にアクセス許可を与えます。'spapi_oauth_code' の値としてverifier code を含むコールバックURL にリダイレクトされます。verifier code の値を保存します。後ほどこれをOAuthVerifier 接続プロパティに設定する必要があります。

次に、OAuth verifier code をOAuth リフレッシュトークンおよびアクセストークンと交換する必要があります。

ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。

OAuthClientId（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーキーに設定。
OAuthClientSecret（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーシークレットに設定。
OAuthVerifier：verifier code に設定。
OAuthSettingsLocation：これを設定すると、暗号化されたOAuth 認証値が指定された場所に永続化されます。
InitiateOAuth：REFRESH に設定。

OAuth 設定ファイルが生成されたら、次のプロパティを設定してデータに接続します。

OAuthClientId（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーキーに設定。
OAuthClientSecret（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーシークレットに設定。
OAuthSettingsLocation：暗号化されたOAuth 認証値を含む場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がプロバイダーに読み書きのアクセス許可を与えることを確認してください。
InitiateOAuth：REFRESH に設定。
Marketplace：販売登録されているマーケットプレイスのリージョンに設定。
Schema：SP-API に接続するにはSellingPartner に設定。
AppId：作成したSelling Partner アプリケーションのアプリケーションId。
AWSAccessKey：OAuthClientId に関連するAWS ユーザーに紐づくアクセスキー。
AWSSecretKey：OAuthClientId に関連するAWS ユーザーに紐づくシークレットキー。

オプション2：OAuth 設定を転送

別のマシンに本製品をインストールして認証し、結果のOAuth 値を転送する方法は次のとおりです。

セカンドマシンに、本製品をインストールして、次の接続プロパティセットで接続します。

OAuthSettingsLocation：書き込み可能な場所に設定。
OAuthClientId（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントシークレットに設定。

認証する接続をテストします。生成された認証値は、OAuthSettingsLocation で指定されたパスにあるファイルに暗号化されて書き込まれます。接続テストに成功したら、OAuth 設定ファイルをヘッドレスマシンにコピーします。ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。

InitiateOAuth：REFRESH に設定。
OAuthClientId（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーキーに設定。
OAuthClientSecret（カスタムアプリケーションのみ）：アプリケーション設定のコンシューマーシークレットに設定。
OAuthSettingsLocation：OAuth 設定ファイルの場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所が本製品に読み書きのアクセス許可を与えることを確認してください。
Marketplace：販売登録されているマーケットプレイスのリージョンに設定。
Schema：SP-API に接続するにはSellingPartner に設定。
AppId：作成したSelling Partner アプリケーションのアプリケーションId。
AWSAccessKey：OAuthClientId に関連するAWS ユーザーに紐づくアクセスキー。
AWSSecretKey：OAuthClientId に関連するAWS ユーザーに紐づくシークレットキー。

ODBC Driver for Amazon Marketplace