HTTP APIデータ・アクションの作成について
ワークブックからREST APIに接続するためのHTTP APIデータ・アクションを作成できます。
ワークブックから選択された列値をREST APIに渡して、そこからレスポンスが返されるように、HTTP APIデータ・アクションを構成します。次の点に注意してください:
-
作成可能なデータ・アクションの数に制限はありません。
-
URLには、コンテキスト値をデータ・アクション(データ値、ユーザー名、ワークブック・パス、キャンバス名など)に渡すトークンを含めることができます。
次のREST API URLの例には、Google books APIを表示するCategory列トークン値が含まれています:
http://www.googleapis.com/books/v1/volumes?q=${valuesForColumn:"Category"}
。Category列のセルから選択した値("Books"など)はREST APIに渡され、それによりリクエストされたページが表示されます。 -
POSTメソッドを使用する場合、またはHTTPヘッダーをオーバーライドするカスタムHTTPヘッダーを使用する場合は、次のことが適用されます:
- "="で区切られた名前と値を持つ名前/値ペアとして各パラメータを入力します。
- 呼び出しているAPIに応じて、同じURLトークン構文を名前/値ペアで使用できます。たとえば:
-
paramName1=paramValue1
-
paramName2=${valuesForColumn:"Product"}
-
- カスタム・ヘッダーは、HTTPリクエストのターゲットが、使用しているHTTPヘッダーをリクエストに設定することを明確に許可している場合に機能します。ヘッダーが許可されない場合、ブラウザはリクエストをブロックし、エラー・メッセージを表示します。たとえば、
Content-Type=application/json
を含むCookieヘッダーはブロックされます。