はじめに
JavaScript Object Notation(JSON)は、使いやすい軽量のデータ交換フォーマットです。JSON No Code OAuthコネクターでは、HTTPSソースからOAuth認証を使用してファイルをインポートできます。JSON APIの詳細については、ウェブサイト( http://jsonapi.org/ )を参照してください。 JSON No Code OAuthアカウントには、Data Centerから接続します。このトピックでは、JSON No Code OAuthコネクターのユーザーインターフェイスに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
JSON No Code OAuthアカウントに接続してDataSetを作成するには、以下が必要です。- アカウント名
- 認証サーバのクライアントIDとクライアントシークレット
- API認証のエンドポイント
- APIアクセストークンのエンドポイント
- この接続に必要なスコープ(オプション)スコープをスペースで区切ります。
- また、アクセストークンを更新する際にリダイレクトURIをAPIに渡す必要があるどうかを指定する必要もあります。
JSON No Code OAuthアカウントに接続する
このセクションでは、JSON No Code OAuthコネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインのオプションである [スケジュール設定] と [DataSetに名前を付け、説明を入力] については、ほとんどのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。[認証情報]ペイン
このペインには、JSON No Code OAuthアカウントに接続するための認証情報を入力するためのフィールドが含まれます。下表は、各フィールドに必要な内容を説明しています。| フィールド | 説明 |
|---|---|
| Account name | アカウント名を入力します。 |
| Client ID | OAuth認証に使用するクライアントID |
| Client Secret | OAuth認証に使用するクライアントシークレット |
| Authorization URL | API認証のエンドポイント |
| Access token URL | APIアクセストークンのエンドポイント |
| Scopes | この接続に必要な範囲を入力します。スコープをスペースで区切ります。 |
| State type | OAuthに要求される状態のタイプを選択します。 |
| State location | 状態をクエリパラメーターとして送信するか、パスで送信するかを選択します。 |
| Response type | 認証URLで使用する応答タイプを選択します。 |
| Use Redirect URI when Refreshing Access Token | アクセストークンを更新する際にリダイレクトURIをAPIに渡す必要があるかどうかを指定します(これは稀です)。 |
注記: Domoで接続する際、既に認証サーバーアカウントにログインしている場合は、 [アカウントを追加] をクリックすると自動的に認証されます。ログインしているアカウントと異なるアカウントに接続したい場合は、まず認証サーバーアカウントからログアウトしなければなりません。
[Data Selection]ペイン
このペインでは、接続先のサーバー/SFTPサイト、JSONファイルの名前、およびその他の構成の設定を指定します。メニュー | 説明 |
|---|---|
| Choose the HTTP Method to use | HttpメソッドとしてGETかPOSTのいずれかを選択します。 |
| Enter the URL to your JSON file | JSONファイルのURLを入力します。 |
| How will you provide the certificate | 証明書を提供する方法を以下から選択します。
|
詳細設定
| メニュー | 説明 |
|---|---|
| HTTPS Headers | HTTPSヘッダーのキーと値を入力します。 |
| Query Parameters | クエリパラメーターのキーと値を入力します。クエリパラメータをエンコードするかどうかを指定します。 |
| Date Query Parameters | 日付クエリのパラメーターとして、日付フィルターなし、単一の日付、または日付範囲を選択します。 |
| JSON Settings | JSONテキストでラインリーダーが必要かどうかと、バックスラッシュ文字をエスケープするかどうかを指定します。 |
解析
ページ設定
データをページ設定する方法を選択します。- 改ページなし
- 結果から次のURLを取得する
- 結果から次のページトークンを取得する
- レコード別にオフセット
- ページ別にオフセット
解析
データプレビューを使用することで、列をクリックして解析用にデータの書式を設定することができます。その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
登録するにはどのリダイレクトURIが必要ですか?
登録するにはどのリダイレクトURIが必要ですか?
**このコネクターは改ページをサポートしていますか?**
**このコネクターは改ページをサポートしていますか?**
はい。改ページを有効にするには、APIでサポートされている改ページタイプを選択して、必要な詳細を入力します。
**データを解析する手順を教えてください。**
**データを解析する手順を教えてください。**
[Parsing]ペインの[Parsing]タブで、拡張または変更するデータが格納されている列を選択します。おすすめのアクションにカーソルを置いて効果を確認し、目的のアクションをクリックして選択します。希望する状態でデータが表示されるまで繰り返します。必要に応じて、右側にある[History]セクションを使用してアクションを取り消します。