CLP - HTTP リクエスト単一のスプレッドシートの取得 – サポートセンター

Workiva の内蔵プレミアムコネクター以外のサードパーティアプリケーションへの接続をお考えですか？HTTPリクエストコネクタのコマンドを活用してREST APIと連携することで、これを実現できます。

この Connected Learning Path では、取得したいスプレッドシートを指定できる Runtime Inputs を使用するようにチェーンを更新します。

プライマリビジネスユースケース	サードパーティシステムとの接続
プライマリ学習目標	Workiva の HTTP リクエストコネクタコマンドを使用して、事前に構築されたコネクタを超えるサードパーティアプリケーションの REST API と対話します。ランタイム入力を使用して、使用するスプレッドシートを指定するようにチェーンを更新します。
二次学習目標	ランタイム入力の使用
前提条件	Workiva API グラントの構成 HTTPリクエストコネクターの構成 CLP一式 \| HTTPリクエスト一覧スプレッドシート
サポートテンプレート	CLP｜HTTPリクエスト単一のスプレッドシートの取得

ステップ 1: チェーンのコピーと修正

「Chain Builder」に移動し、「ChainCLP | HTTPリクエスト一覧スプレッドシート」を探してください。
縦の省略記号をクリックして、チェーンをコピーしてください。
鉛筆アイコンをクリックして、チェーンを編集します。
右上の「チェーン設定」をクリックし、チェーンの名前を「CLP | HTTPリクエスト：単一のスプレッドシートを取得」に変更します。
（任意）説明を入力してください：「このチェーンは、新しい Workiva API アクセストークンを生成します。以下の変数値に、前へ生成した API Grant の有効な Client ID と Client Secret を入力する必要があります。チェーンが実行されると、ユーザーにスプレッドシートIDの入力を促します。チェーンがスプレッドシートを取得します。"
チェーンを守ろう。

「ランタイム入力チェーンイベント」を使用して、チェーンを開始します。
これにより、取得したいスプレッドシートのスプレッドシートIDを指定することができます。Runtime Inputsの詳細はこちら。

「POST - トークンの取得」コマンドをスタートノードから移動させる。
「チェーン・トリガー・イベント」から「ランタイム入力チェーン・イベント」を「開始ノード」に追加します。
「Runtime Inputs」と「Get - List Spreadsheets」コマンドを結びつけているリンクをダブルクリックし、そのリンクを削除してください。
ランタイム入力を「POST - トークンの取得」コマンドに接続します。
「POST - トークンの取得」コマンドを「GET - スプレッドシートの一覧表示」コマンドに接続します。
「ランタイム入力チェーン」イベントをダブルクリックして、設定を行います。
[入力の追加] をクリックし、以下のフィールドを設定します：
- タイプ：テキストフィールド
- 表示名：スプレッドシートID - IDの探し方については、こちらのドキュメントをご覧ください
- 必須：このチェックボックスにチェックを入れてください
（任意）説明を入力してください：「このコマンドを使用すると、ユーザーは必要な実行時入力の値を指定できます。」
コマンドを保存します。

ワークスペース内のすべてのスプレッドシートを一覧表示する代わりに、単一のスプレッドシートの詳細を表示するように、HTTP Request Get コマンドを更新します。

（任意）説明を入力してください：「このコマンドは、1つのスプレッドシートを返します。詳細については、https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html の開発者向けドキュメントを参照してください。
コマンドを保存します。

チェーンが完成したので、結果をテストしよう。

チェーンを公開する。
[実行] をクリックし、続いて [入力データ付きで実行] をクリックします。
探す スプレッドシート ID、Workivaプラットフォーム内のスプレッドシートに移動することで。付与ユーザーにこのスプレッドシートの権限があることを確認してください。
[スタート] をクリックします。
チェーンの実行が完了すると、「出力」タブ内の「Getコマンドのレスポンス本文」に、スプレッドシートの詳細が生成されていることが確認できます。