接続の作成の前提条件

APIクライアントの作成

URL https://account.demandware.comを使用してアカウント・マネージャにログインします。
「APIクライアント」をクリックします。
「APIクライアントの追加」をクリックします。「Add APIクライアント」ページが表示されます。
表示名とパスワードを入力し、パスワードを確認します。
APIクライアント・パスワードの値をコピーします。 Oracle IntegrationでSalesforce Commerce Cloudアダプタ接続のセキュリティを構成する場合は、この値を「クライアント・シークレット」フィールドに入力する必要があります。「接続セキュリティの構成」を参照してください。
「組織」セクションで、「追加」をクリックして組織をAPIクライアントに割り当てます。組織のリストが表示されます。
APIクライアントに割り当てる組織を選択し、「追加」をクリックします。
(オプション)「ロール」セクションで、「追加」をクリックしてAPIクライアントにロールを割り当てます。ロールのリストが表示されます。
「SalesforceコマースAPI」ロールを選択し、「追加」をクリックします。
必要な詳細をすべて入力したら、「保存」をクリックします。
完了したら、「APIクライアント」をクリックします。新しいAPIクライアントの詳細が「APIクライアント」ページのリストに表示され、APIクライアントIDが表示名で識別されます。

ノート:
後で「Salesforce Commerce Cloudアダプタ」接続のセキュリティを構成するときにクライアントIDを使用します。「接続セキュリティの構成」を参照してください。

オープン・コマースAPI設定の構成

ノート:

Shop APIの場合、Open Commerce API (OCAPI)設定のサイト・コンテキストで構成された操作が、アダプタ・エンドポイント構成ウィザードの操作ページに表示されます。サイト・コンテキストに操作が構成されていない場合、グローバル・コンテキストで構成された操作が操作ページに表示されます。
データAPIでは、OCAPI設定のグローバル・コンテキストで構成された操作のみが、アダプタ・エンドポイント構成ウィザードの操作ページに表示されます。

OCAPI設定を構成する必要があります。これらは、APIを起動するためにOCAPIクライアント権限を管理するために必要な必須設定です。実行する必要がある操作に対する権限をOCAPIクライアントに付与する必要があります。 OCAPI設定で構成された操作のみが、アダプタ・エンドポイント構成ウィザードのOperationsページに表示されます。

OCAPI設定を構成できます。「Business ManagerでのOCAPI設定の構成」を参照してください。

ノート:

OCAPI設定で構成された操作は、Salesforce Commerce Cloudのキャッシュ・メカニズムのため、アダプタ・エンドポイント構成ウィザードの操作ページに即時に表示されない場合があります。キャッシュを無効にすると、構成された操作を遅延なく確認できます。
OCAPI設定で操作が構成されていない場合、OCAPIはクライアント・アプリケーション・リクエストを拒否し、HTTP 403 (Forbidden)エラー・ステータス・レスポンス・コードを返します。

また、「Salesforce Commerce Cloudアダプタ」接続を作成する前に、OCAPI設定でクライアントに提供する必要がある最小限のアクセス権限(次の表を参照)があります。これらのAPIは、「Salesforce Commerce Cloudアダプタ」でメタデータ情報を収集するために使用されます。

HTTPメソッド	API	目的
GET	/sites	サイト固有のフィールド内のフィールドに移入するサイトのリストを取得します。
GET	/locale_info/locales	ローカライズされたフィールドに移入するロケール情報のリストを取得します。
GET	/system_object_definitions/{object_type}/attribute_definitions	マッパーで「バリエーション値」キーを作成するための「製品」オブジェクトの属性定義のリストを取得します。
GET	/custom_object_definitions/{object_type}/attribute_definitions	カスタム・オブジェクトの属性定義のリストを取得します。

現在のSalesforce Commerce Cloud APIバージョンの検索

現在のSalesforce Commerce Cloud APIバージョンは、独自のAPI(メタAPI)にアクセスすることで確認できます。メタAPIは、使用可能なAPIに関する情報を提供します。

ブラウザを開き、次の形式でURLを入力します:
```
https://my_instance/s/-/dw/meta/rest/data
```
Salesforce Commerce CloudインスタンスによってリリースされたAPIバージョンのリストが表示されます。
表示されたリストで、nameフィールドにはAPIバージョンのSalesforce Commerce Cloudインスタンスが表示され、statusフィールドにはAPIバージョンのステータス(廃止、非推奨、現在など)が表示されます。

ノート:
「Salesforce Commerce Cloudアダプタ」は、現在および非推奨のAPIバージョンをサポートしています。
一番下までスクロールし、ステータスがcurrentのAPIバージョンを見つけます。たとえば:
```
"name":"20.10","status":"current"
```