カスタムコネクタの作成

カスタムコネクタの作成

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

Notes
メモ:この機能はC6でのみアクセス可能です。
カスタム Connectorsは、Zoho Creatorの組み込み connectorsに含まれていないサービスと連携するように設計されています。目的のサービスのコネクターを設定し、接続を確立することができます。Connectorsについての詳細はこちら 。
Notes
メモ:PayPal、PayflowPro、および支払い Proの既存バージョンは、2024年9月26日にサポート終了し、この日付以降はいかなる支払い取引も処理されません。継続した支払い処理を維持するために、最新バージョンへのアップグレードが必要です。 。詳細はこちら'カスタム コネクター作成' へ移動する

カスタムコネクターを作成するには、次の手順に従ってください。

カスタム コネクター:Microservicesに移動します。

  1. タブ。 クリック して'新しく作成'を選びます。

  2. 右上隅にある'新しく作成'をクリックします。 選択する Connection

  1. をクリックし、「ピックアンドビルド」を作成します。左のカスタムコネクタにクリックします。

  1. 左側のペインにあるカテゴリーを選択し、クリックして新たにカスタムコネクタを作成します。

  1. 注記：こちらをクリック

Notesこちらをクリックして「カスタムコネクタを作成する」に関する他の方法を参照してください。 カスタムコネクタを作成したことがある場合、それらはカスタムコネクタページのカードとして表示されます。 「+新しく作成」をクリックしてください。

  1. 右上のアイコンをクリックすると、ビルダーが表示されます。次に、 「次のセクション」 の手順に従ってご自身のカスタム コネクターを作成。また、カスタム コネクター カードをクリックして接続を確立することもできます。詳細はこちら

カスタム コネクターを作成する以下の重要な設定がカスタム コネクターを作成するために必要です:

一般

カスタム コネクターの基本情報には、以下のような内容が含まれます。

    • コネクター名、コネクター リンク 名前、説明、および ロゴ。セキュリティは、 カスタム コネクターの認証設定を定義し、例えば 認証タイプ、 認証パラメーター、

    • および スコープ。以前の指示に続いて、コネクター名と説明を入力します。

    1. カスタムコネクタ用に。 コネクタ名は、作成したいコネクタの表示名です。 メモ: コネクタ名には次の特殊文字のみ使用できます * _ - @ / ! : | & ~ \ +

    • および 文字数は50文字を超えることはできません。

    Notes   コネクタ名は文字か数字、もしくは_ (アンダースコア)で始まる必要があります。
    説明(任意)は、カスタムコネクタに関する追加情報を格納するテキストボックスです。 メモ: 説明に使用できる特殊文字は以下の通りです
    , . ( ) - _ * @ / \ ! : | ~ | &

    • および文字数は255文字を超えることはできません。 クリック

    Notes カスタムコネクタを作成します。一般セクションにリダイレクトされます。一般 - 基本的なコネクタの詳細を更新する  

    1. 一般 セクションにはコネクタの基本的な詳細が含まれています。 The

    コネクタ名, コネクタ リンク名,

    そして 説明 は初期ページで自動的に入力されます。差出人は、それぞれの項目をクリックすることで編集することもできます。

    1. メモ: コネクター リンク 名前は文字で始まる必要があり、50文字を超えてはいけません。コネクター リンク 名前には、アンダースコア以外の特別な文字を含めてはいけません。 カスタム コネクター用のロゴをアップロードしてください。 メモ:

    Notes   画像サイズは1MB未満でなければなりません。
    唯一
    PNG, JPG,  

    1. そして

    Notes

      JPEG

      画像フォーマットがサポートされています。
    3.クリック保存 & 続けると、Securityセクションにリダイレクトされます。

    セクション。 メモ: コネクターを作成するには2つの段階があります:下書き そして Ready.



    Notes   コネクターのステージは右上に表示されます。
      - 最初は下書きとしてマークされます。コネクターが下書きのステージにある間は、外部連携を作成することはできません。
    - 必要な認証の詳細をすべて完了したら、「設定 as Ready」とクリックして準備ができた状態にできます。コネクターが準備完了とマークされると、下書きステージに戻すことはできません。
    セキュリティ - 認証の詳細を指定セキュリティセクションでは、ニーズに基づいた認証を設定することができます。サポートされている
    認証タイプおよびそれらの詳細は、以下の表に記載されています。アプリケーションに必要な認証のタイプを選択し、クリックしてください。

    保存 & 続ける

    as shown. Authentication 種類 説明 項目 基本 これはターゲットサービスのAPI文書に記載されているキーを指定する必要があります。
     


    接続認証フェーズでは、コネクター 設定を求められます

    この段階で、パラメーター（ユーザー名とパスワード）のための値を入力してください。これらはbase64アルゴリズムを使用して自動的に暗号化され、形式: 基本 のヘッダーとして渡されます。

    パラメーター名

    : これはプロンプトされる項目の表示名です

    接続認証中です。 メモ:パラメーター名


    次の特殊文字だけを含めることができます * _ - @ / ! : | & ~ \ + パラメーター名
    Notes
    文字か数字で始める必要があります。

    • パラメーターキー: 対象サービスで指定されているAPIキーです API

    • 説明文書。このキーに対して送信されるべきパラメーター値について言及されています。パラメーター名
    接続認証中に。 APIキー この機能により、APIキーを用いてサードパーティのAPIに接続することができます。APIキーは認証目的のためのユニークな識別子として機能します。 パラメーター名 :パラメーターの表示名です。この名前

    接続認証時にプロンプトが表示されます。


    メモ: パラメーター名


    は以下の特殊文字のみを含めることができます * _ - @ / ! : | & ~ \ +パラメーター名
    Notes
    は文字または番号で開始する必要があります。

    • パラメーターキー: これは、指定されたAPIドキュメントの 対象サービスに対してパラメーター値を送信する必要があります。

    • メモ: 上記の
    パラメーター キーは差し込み項目の値であり、接続認証の際に指定されたパラメーター名前でプロンプトが表示されます。

    NotesParameter 場所 : これは認証パラメーターが指定されたURLと一緒にどう送信されるかを決定しますinvoke URL


    スクリプトでサポートされているパラメータのタイプは クエリ文字列、フォームデータ、そしてヘッダー。 OAuth1 OAuth1プロトコルは、アプリケーションがAPIを介して第三者のリソースにアクセスできるようにしながら、ユーザーのクレデンシャルを開示せずにCreatorアプリケーションのアクセスを可能にします。ユーザーが承認すると、Creatorアプリケーションは第三者サービスによって提供されるアクセストークンを使用してユーザーのリソースにアクセスできるようになります。OAuth1は、Webベースのアプリケーションと接続する場合にのみ効率的です。これは、接続の安全を確保するために、暗号署名と一時的なトークンを使用します。Consumerキー：これは

    OAuth1でのユニークな識別子は、サービスプロバイダへのリクエストを行うアプリケーションを識別する際に使われます。アプリケーションによっては機密扱いされるべきものです。
    メモ： Consumerキー
    は、アルファベット文字及び以下の特殊文字「 # $ % & ‘ ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ` ~ 」を含むことができ、半角スペースを1つ含むことができます。 Consumerキーは、必ず日本語でなければなりません。
    Notes
    Consumer シークレット
    1. : コンシューマ シークレット キーとは、OAuth1においてコンシューマ キーに関連付けられたシークレット キーであり、サードパーティアプリケーションがサービスプロバイダに対して行うリクエストに使用されるものです。
    2. メモ:Consumer シークレット
    には英数字および特殊文字 “ # $ % & ‘ ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ` ~ が含まれ、スペースを単一含むことができます。Consumer シークレットは日本語で入力する必要があります。Authorization URL
    Notes
    :
    1. このURLは、望まれるサービスのAPIドキュメントに記載されているとおり、アプリケーションアクセスの認証を取得するためのものです。Token URL:
    2. このURLは、望まれるサービスのAPIドキュメントで指定されたリクエストトークンと引き換えにアクセストークンを取得するためのものです。Request Token URL:
    このURLは、アプリケーションとサードパーティサービス間での認証プロセスを開始するために使用されるリクエストトークンを取得するためのものです。取り消す Token URL: このURLは、OAuth1アクセスまたは更新トークンを取り消すためものです。取消トークンリクエストは、指定されたトークンに関連付けされたクライアントの権限の削除を引き起こします。

    メモ:URLはプロトコル (http/https)、ホスト名 (

    www。zylker。com) およびファイル名（index）。

    例: https://www。zylker。com/index
    Notes
    OAuth1は、ユーザーが認証を許可した後、サーバーがユーザーをCreatorアプリケーションに自動的にリダイレクトし、アプリケーションが保護リソースにアクセスするために使用する認証コードまたはアクセストークンを渡すことができます。
    1. OAuth2Authentication - OAuth2OAuth 2を使用すると、ウェブサーバー上でユーザーデータへの限定的なアクセスを提供します。OAuth 2サーバーは、Creatorアプリケーションがユーザーの代わりに保護リソースにアクセスするために使用できるアクセストークンを発行します。また、OAuth2には、Creatorアプリケーションがユーザーから特定の権限を要求することを可能にするスコープが含まれており、ウェブベースおよび非ウェブベースのアプリケーションの両方と互換性があります。許可タイプ
    2. : 許可されたリソースへのアクセス方法を参照します。サポートされている許可タイプには以下のものがあります。

    認証コード


    PKCE付き認証コード


    すべてのグラントタイプのAuthorizationパラメータはヘッダーにて送信されます。
    1. Clientシークレット
    2. コネクタを使用する際は、parameterが次の値と等しいことが必須です
    3. PKCEを伴うAuthorizationコード
    Notes
    以下のようなグラントタイプを持っています。 
    1. クライアントID
    2. : サービスプロバイダーによって発行されたクライアントID。メモ:クライアントIDは、英数文字と次の特殊文字が含まれることができます。“ # $ % & ‘ ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ` ~ 、単一の空白を含むことができます。


    クライアントシークレットには、日本語以外の言語は含めることはできません。クライアント シークレット

    Notes
    : クライアントのシークレットが認証に
    1. 必要なアプリケーション。メモ:
    2. Client シークレットは、英数字および以下の特殊文字を含めることが可能です。“ # $ % & ‘ ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ` ~。空白を1つ含むこともできます。
    Client シークレットには、日本語を除く他言語を含めることはできません。
    Token URL
    Notes
    : APIで指定された通りのアクセストークンを取得するためのURL

    • ご希望のサービスのAPIドキュメント。メモ:

    • 以下に特定されるリクエストトークンURLと取り消しトークンURLは、付与タイプが「Authorization コード」として選択された場合のみ適用されます。取り消しトークンURL
    : 指定されたOAuth2アクセスを取り消すURLまたは更新するトークン。取り消しトークンリクエストによって、指定されたトークンに関連付けられたクライアントの権限が削除されます。

    NotesToken URLを更新する:新規 access tokens にアクセスするURLは、

    現在のaccess tokenが無効になったり、期限が切れたりした場合です。メモ:URLは、スタンダードな形式である必要があります。


    プロトコル(http)、ホスト名( www.zylker.com)、およびファイル名(index)である必要があります。例えば、
    Noteshttp://www。zylker。com/index。詳細 パラメーターBearer 名前 : 認証ヘッダーで接頭語として機能するテキスト APIリクエスト用です。有効期限: アクセストークンが有効期限を迎える秒数です。デフォルトの有効期限は3600秒です。


    注意:

    Bearer 名前は、英数字のみである必要があります。


    期限日時 は、数値のみを含むことができます。
    Notes
    期限日時

    • は15分より短い、または24時間を超えることはできません。OAuth Scopes (オプショナル)

    • - これはアクセストークンを通じて与えられるユーザーへのアクセスレベルを制限します。Scope 表示名:

    • サードパーティのScopeの表示名。メモ:Scope 表示名


    次の特殊文字のみ含めることができます * _ - @ / ! : | & ~ \ + Scope 表示名 は、文字または数字で始める必要があります。Scope 表示名は、文字または数字で始まる必要があります。

     

    最大50個のスコープを追加できます。 スコープ値:

    Notes
    ご要求のアクセスレベル
    1. 第三者サービス。スコープ区切り文字:
    2. 求められるサービスAPIがスコープを分割する方法である区切り文字。
    3. メモ:
    初期設定のスコープ区切り文字はコンマになります。 認証種類が選択され、カスタムコネクタを作成する設定部分が異なります。基本認証とAPIキー認証を設定する手順


    OAuth1認証を設定する手順 OAuth2認証を設定する手順基本認証とAPIキー認証を設定する手順

    Notesメモ:以下の手順は両方の認証タイプで同様です。

     

    APIキー
    1. および
    2. 基本認証
    3. の種類です。指名されるのは

    認証パラメータ

    Notes 項目を変更する場合、APIキーを例に挙げて考慮しました。「認証種類」を選択した後、認証パラメータを入力し保存をクリックします。ここではOpen Weatherを例に示しています。
    1. Authentication 種類は下記に示すように、編集アイコンをクリックして変更することができます。 メモ: Authentication 種類は、 コネクターが下書き段階にある場合のみ変更可能です。これにより、コネクターの設定がすべて失われます。コネクターが準備完了としてマークされると、Authentication 種類は変更できません。 認証詳細を入力した後、コネクターを準備完了として設定してください。

    2. 認証詳細を入力した後、コネクターを準備完了として設定してください。 段階は差出人 下書きに変更されました


      Notes
      Ready状態になったら、コネクションを追加することができます。

    3. コネクションを追加する


    4. ボタン。
      OAuth1認証の設定手順目的のサービスのAPIドキュメントに記載されている通りにAuthentication パラメーターを入力して、保存をクリックします。例えば、私たちは使用しています

    1. Trello を例に。 コネクタが準備完了とマークされたら、ボタンをクリックすることで外部連携を

    外部連携の追加

    1. OAuth2認証の設定手順認証パラメータを指定して


    2. 詳細パラメータは以下の通りです。たとえば、Dropboxを使用しています

    例として。

    1. メモ:The リクエストトークンURL および 取り消すトークンURL の項目は、 グラント種類 が以下に設定された場合のみ表示されます:
      認証コード型.


      Notes
      各パラメーターの詳細については、項目の初期設定値としてBearerをBearer 名前に、また3600を

    2. 有効期限. これらの値は必要に応じて更新できます。メモ: Bearer 名前は英数字のみ含むことができます。有効期限は数字のみ含むことができます。有効期限は
      Notes
      15 分未満または24 時間以上であってはなりません。
      クリックして保存 & 続行。コネクタを使用準備完了と設定します。オプションのスコープは、準備完了とマーキングする直前に追加できます。次の手順に従ってください：
      次章でさらに情報を得るために。メモ:
      コネクタが準備完了とマークされたら、認証パラメータは編集できません。

    3. 指定された認証パラメータは、接続認証中にプロンプトが表示されます。使用中の認証種類によって、カスタムコネクターの接続認証に差異が生じます。追加のOAuthスコープ(OAuth2のみ適用) - オプションメモ:
    OAuth コネクターにはスコープを追加することを強く推奨します。OAuth2ではスコープはオプションですが、それでもです。
    OAuth2で Authentication パラメーターを保存した後には、次に導かれます
    OAuth Scopes セクション、またはクリックでそこに移動すること OAuth Scopes左のペインから。次のページで、クリックします

    +スコープを追加する。
    Notes 以下に Scope 名前

    1. および Scope 値 をクリックして追加します。ここではDropboxのスコープを追加することを検討しました。 Dropbox。 「新しく追加する」ボタンをクリックして、他のスコープを追加します。

    1. 右上の三点リーダーをクリックして 編集

    1. または 削除 テーブル内の特定のスコープデータを。 複数のスコープを削除する場合は、チェックボックスを選択して削除をクリックします。 下記のように表示されます。特定のスコープを 検索 するには、スコープの名前や値を入力してください。

    1. タブをクリックし、「 準備完了 」として設定します。

    1. ボタンをクリックすると、ステージは「下書き 」から「 準備完了 」に変更されます。 コネクタが「 準備完了」とマークされたら、

    1. 「 外部連携を追加する」よりコネクションを追加できます。メモ:

     

    追加した外部連携では、編集や削除ができなくなります。カスタム コネクターを使って外部連携を行った場合にも同様です。

    1. カスタム Connectorsは、Delugeスクリプトのinvoke URL タスクを使用して呼び出す必要があります。特定のシナリオ/ワークフローに対して適切な操作 API を指定してください。 「新しく作成する カスタム コネクター」にアクセスする方法は複数あります。


    2. 管理 カスタム Connectorsページから、あるいは追加する外部連携ページの組み込みコネクタ カテゴリーから、または管理 カスタム コネクターページから1. 「カスタム コネクターの管理」に移動します。

    Notes   Microservices
    ページを下にスクロールすると外部連携セクションがあります。
    2. 外部連携が3つ以下の場合は、画面上の管理 カスタム Connectorsをクリックしてください。外部連携セクション。

    3. iii) 外部連携が3つを超える場合は、  

    メモ:

    代わりに、外部連携タブから上部にナビゲーションして、すべての外部連携のリストを表示することができます。ii) 「管理 カスタム コネクター」をクリックします。


    4. 「+カスタム コネクターを作成する」をクリックします。5. カスタム コネクターがカードとしてリストアップされている場合は、右上隅の「+新規作成」アイコンをクリックしてカスタム コネクターを作成します。


    「あなた自身のカスタム コネクターを作成する」セクションに記載された手順に従って、自分のカスタム コネクターを構築します。

    Notes
    「外部連携の追加」ページの「組み込みコネクタ」カテゴリーから、「Microservices」タブに移動し、クリックします。

    右上隅の「+新規作成」をクリックします。選択します。


       

    接続 およびクリック


    抽出 & 作成. 組み込みコネクターページの最後までスクロールしてクリック +カスタム コネクターを作成.


    メモ:目的の コネクター を見つけるために検索 タブを使用. もしコネクターが 組み込みコネクターリストにない場合は、

    次に表示されます

    1. +カスタム コネクターを作成 リンク. このリンクをクリックして 新しい カスタム コネクターを作成します. 下記のステップに従って あなたのカスタム コネクターを作成してください


    1. 独自のカスタム コネクターを構築するためのセクション。 関連トピック： コネクターの概要、 カスタム コネクターの管理、

    2. 外部連携の理解、 作成および外部連携の認証。

    Notes ${LOC_511}$${LOC_512}$${LOC_513}$${LOC_514}$${LOC_515}$${LOC_516}$${LOC_517}$

    1. ${LOC_518}$${LOC_519}$ ${LOC_520}$

    ${LOC_521}$               

    1. コネクタについて理解する
    2. カスタムコネクタの管理
    3. コネクションの理解
    4. コネクションの作成と認証

     

     

     

     

     

     

      Zoho CRM 管理者向けトレーニング

      「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

      日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

      Zoho CRM Training



                Zoho WorkDrive Resources




                  Zoho Desk Resources

                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day






                            Latest Feature Updates



                                    • Related Articles

                                    • カスタムコネクタの管理

                                      お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 注記: カスタム connectorsはCreator 6をご利用のユーザーのみが使用可能です。 カスタム Connectorsの管理 注記: 既存のPayPal, PayflowPro, および 支払い ...

                                    Resources

                                    Videos

                                    Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                    eBooks

                                    Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                    Webinars

                                    Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                    CRM Tips

                                    Make the most of Zoho CRM with these useful tips.