構文
Web.Headers(url as text, optional options as nullable record) as record
バージョン情報
urlからダウンロードしたヘッダーをレコードとして返します。 追加のプロパティを指定するために、省略可能なレコード パラメーター (#B0) を指定できます。 レコードには、次のフィールドを含めることができます。
Query: プログラムでクエリ パラメーターを URL に追加します。エスケープについて考える必要はありません。- #B0: ターゲット サイトに API キーの概念がある場合、このパラメーターを使用して、URL で使用する必要があるキー パラメーターの名前 (値ではない) を指定できます。 実際のキー値は資格情報で指定されます。
- #B0: レコードとしてこの値を指定すると、HTTP 要求に追加のヘッダーが提供されます。
Timeout：この値を期間として指定すると、HTTPリクエストのタイムアウトが変更されます。 既定値は 100 秒です。- この値をリストとして指定すると、これらの HTTP ヘッダーキーはデータキャッシュの計算から除外されます。
- #B0: この論理値を true に指定すると、データをフェッチするときにキャッシュ内の既存の応答は無視されます。
- #B0: この値をリストとして指定すると、応答にこれらの状態コードのいずれかが含まれる HTTP 要求に対する組み込み処理ができなくなります。
RelativePath: この値をテキストとして指定すると、要求を行う前にそれがベース URL に追加されます。
HTTP 要求は HEAD メソッドを使用して行われます。 カスタム データ コネクタ コンテキストの外部では、応答ヘッダーのサブセットのみが使用できます (セキュリティ上の理由から)。
例 1
RelativePath オプションと Query オプションを使用して、 "https://bing.com/search?q=Power+Query" の HTTP ヘッダーを取得します。
使用方法
let
searchText = "Power Query"
in
Web.Headers(
"https://www.bing.com",
[
RelativePath = "search",
Query = [q = searchText]
]
)
出力
([
#"Cache-Control" = "private, max-age=0",
#"Content-Encoding" = "gzip",
#"Content-Length" = "0",
#"Content-Type" = "text/html; charset=utf-8",
Date = "Tue, 14 Dec 2021 16:57:25 GMT",
Expires = "Tue, 14 Dec 2021 16:56:25 GMT",
Vary = "Accept-Encoding"
]
meta [
Response.Status = 200
])