カスタムコネクタの管理

カスタムコネクタの管理

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Notesメモ: カスタムコネクター は、Creator 6をご利用のユーザーのみ使用できます。
Notes
メモ: 既存バージョンの PayPal、PayflowPro、Payments Pro は 2024 年 9 月 26 日をもってサポートを終了しており、この日付以降は支払い取引は処理されません。支払い処理を中断なく継続するには、最新バージョンへ移行してください。詳細はこちら
1. Microservices タブに移動し、外部連携セクションまでスクロールします。


2. 外部連携が 3 件以下の場合は、カスタムコネクターを管理をクリックします。このボタンは外部連携セクション内に表示されます。

3. i) 外部連携が 3 件より多い場合は、その他を表示をクリックします。アカウント内のすべての外部連携の一覧が表示されます。

Notesメモ: 別の方法として、上部の外部連携タブに移動して、外部連携の全リストを表示することもできます。


 

ii) カスタムコネクターを管理をクリックします。


              

4. すべてのカスタムコネクターがカード形式で一覧表示されます。

  • ステージと認証タイプは、各カードの下部に表示されます。

  • コネクターカードが無効 状態の場合は、グレー表示になります。

  • 特定のコネクターを探すには、検索ボックスを使用し、コネクター名やコネクターリンク名などのキーワードを入力します。

  • また、フィルタードロップダウンを使用して、カスタムコネクターをステージ下書きReadyすべて など)に基づいてフィルタリングできます。


  • 次の設定にアクセスするには、コネクターカードにカーソルを合わせ、三点リーダー (三つの点)アイコンをクリックします。

Notes メモ: 接続を追加および参照の設定は、下書き ステージのコネクターには表示されません。     

 

5. 画面右上の+ 新規作成ボタンをクリックして、新しいカスタムコネクターを作成することもできます。

 

カスタムコネクタを編集する

「下書き」ステージにあるコネクタを編集する

1. カスタムコネクタの管理」ページに移動します。

2. 「 下書き」ステージにあるコネクタカードをクリックして編集します。

 

または、編集したいコネクタカードにカーソルを合わせ、カード右上の三点リーダー(三つの点)アイコンをクリックし、

コネクタを編集]をクリックします。


 

3. ビルダーの[一般]セクションが表示され、右側のペインに最終更新の詳細が表示されます。コネクタが

下書きステージにあるため、すべてのセクションは初期設定で編集モードになっています。


4. 左側のペインで、編集したいセクションをクリックします。

5. たとえば、認証パラメーターを編集する場合は、左側のペインで[Authentication]をクリックします。

 

6. 更新したい情報を入力し、[保存]をクリックします。

 

7. 認証の詳細を入力したあと、コネクタのステージを「下書き」から「Ready」に変更するには、[Ready に設定]ボタンをクリックします。

 

Notes    メモ:  
- 必須の認証情報をすべて入力するまで、コネクタをReady に設定することはできません。
- 認証タイプは、コネクタが下書きステージにある場合にのみ変更できます。このとき、コネクタの設定はすべて失われます。

- コネクタが無効になっている場合、有効化せずに下書きステージで Ready に設定したり、そのコネクタを使用して外部連携を追加したりすることはできません。 有効化する必要があります。

「Ready」ステージにあるコネクタを編集する

Notes メモ:
コネクタが Ready ステージにある場合:
- 認証タイプは変更できません。
- OAuth2 のスコープは編集も削除もできません。

1. 「カスタムコネクタの管理」ページに移動 します。

2. 「Ready」ステージにあるコネクタカードをクリックして編集します。

 

または、編集したいコネクタカードにカーソルを合わせ、三点リーダー (カード右上の三つの点のアイコン)をクリックし、

コネクタを編集]をクリックします。

 

3. ビルダーの[一般] セクションが表示され、右側のペインに最終更新の詳細が表示されます。すべてのセクションは

読み取り専用モードになっています。

 

4. 更新したいセクションで[編集]をクリックします。

5. たとえば、基本的なコネクタの詳細を編集する場合は、[基本コネクタ詳細]セクションの[編集]をクリックします。

 

6. 同様に、認証パラメーターを編集するには、[Authentication] を選択し、[編集]をクリックして[Authentication]の設定を変更し、更新後に[保存]を選択します。


  1. 以下のいずれかの認証パラメーターを変更すると、関連付けられている接続の現在の認可が取り消され、再認可が必須になります。
    1. APIキー認証
      1.1. パラメーターキー
    2. OAuth1 認証
      2.1. コンシューマーキー
      2.2. コンシューマーシークレット
    3. OAuth2 認証
      3.1. グラント種別
      3.2. クライアントID
      3.3. クライアントシークレット
  2. コネクター内で上記の認証パラメーターのいずれかを編集すると、関連するすべての接続参照が表示されます。これらの参照は、認証済みの接続に対してのみ表示されます。変更の影響を受けるのはこれらの接続のみであるためです。
  3. コネクターレベルでの認証パラメーターの変更は、関連付けられているすべての認証済み接続に影響します。接続を更新すると既存の認可は無効になり、再認可が必須となります。

カスタムコネクターの削除

1. [Manage custom connectors]ページに移動 します。

2. 削除したいコネクターカードにカーソルを合わせます。

3. カード右上の三点リーダー(三つの点)アイコンをクリックし、 [削除]

  • コネクターがいずれの接続でも使用されていない場合は、表示される確認ポップアップで[はい]をクリックすると、すぐに削除されます。  

  • それ以外の場合は、そのコネクターを使用しているすべての場所の参照を一覧表示するポップアップが表示されます。

  • コネクターを削除し続けるには、表示されているすべての参照先の接続を削除する必要があります。

 

カスタムコネクターで接続を追加する

1. [Manage custom connectors]ページに移動 します。

2. 接続を作成したいReady ステージのコネクターカードにカーソルを合わせます。

3. 三点リーダー (三つの点)アイコンをカード右上でクリックし、[接続を追加] をクリックします。


接続を追加]をクリックすると、そのコネクターを使用して接続を作成するよう求められます。

 

また、ビルダー画面からではなく、コネクターに対して直接接続を追加することもできます。

  • Ready ステージにあるコネクターカードをクリックします。

  • そのコネクターでまだ接続が作成されていない場合、ビルダー画面の右上に[接続を追加]ボタンが表示されます。

  • 接続を追加]ボタンをクリックして、そのコネクターで接続を作成 します。

Notes メモ: カスタムコネクターが下書き ステージにある場合や、無効状態の場合は、接続を追加できません。

カスタムコネクターの参照を表示する

Notes メモ: 下書きステージにあるコネクターには、参照オプションは表示されません。   
1. [Manage custom connectors]ページに移動 します。
2. 参照を確認したいReady ステージのコネクターカードにカーソルを合わせます。

3. 三点リーダー (三つの点)アイコンをカード右上でクリックし、[References]をクリックします。

 

4. または、[Ready] ステージにあるカスタムコネクターカードをクリックすると、ビルダー画面が表示されます。

Ready コネクターのビルダー画面右上にある References をクリックします。


5. そのコネクターに関連付けられているすべての接続参照の一覧が、ポップアップで表示されます。

6. コネクターに関連付けられている外部連携がない場合は、ビルダー内の 接続を追加 ボタンが、References の代わりに表示されます。

カスタムコネクターを有効化/無効化する

Notes
   メモ:
- コネクターを無効化すると、そのコネクターを使用して新しい外部連携を作成できなくなります。
- コネクターを無効化するには、そのコネクターに関連付けられているすべての外部連携を無効化する必要があります。
- コネクターを無効化しても、認可データは失われません。コネクターが有効な状態であれば、設定済みの認可情報で引き続き動作します。
- 無効状態のコネクターを Ready として設定することはできません。
1. [Manage Custom Connectors] ページに移動します。
2. 有効化または無効化したいコネクターカードにマウスオーバーします。

3. カード右上の 三点リーダー (三つの点)アイコンをクリックし、無効にする または 有効にする をクリックします。

すべての参照の一覧が表示されます。

 

4. そのコネクターに関連付けられている外部連携がある場合は、続行する前にそれらを無効化する必要があります。トグルをクリックして関連付けられている外部連携を無効化し、続けて無効にする をクリックします。


 

関連トピック