Web.Headers

  • [アーティクル]

構文

Web.Headers(url as text, optional options as nullable record) as record

詳細

url からダウンロードされたヘッダーをレコードとして返します。 省略可能なレコード パラメーター options を指定して、追加のプロパティを指定することができます。 レコードには、次のフィールドを含めることができます。

  • Query:クエリ パラメーターをプログラムで URL に追加します。エスケープについて考える必要はありません。
  • ApiKeyName:ターゲット サイトが API キーに対応している場合、このパラメーターを使用すると、URL で使用する必要があるキー パラメーターの名前 (値ではない) を指定できます。 実際のキー値は、資格情報で指定されます。
  • Headers:この値をレコードとして指定すると、HTTP 要求に追加のヘッダーが指定されます。
  • Timeout:この値を期間として指定すると、HTTP 要求のタイムアウトが変更されます。 既定値は 100 秒です。
  • ExcludedFromCacheKey:この値をリストとして指定すると、これらの HTTP ヘッダー キーが、データをキャッシュする計算から除外されます。
  • IsRetry:この論理値を true に指定すると、データをフェッチするときにキャッシュ内の既存の応答が無視されます。
  • ManualStatusHandling:この値をリストとして指定すると、応答にこれらのいずれかの状態コードが含まれる HTTP 要求に対するビルトイン処理が回避されます。
  • RelativePath:この値をテキストとして指定すると、要求を行う前にこれがベース URL に追加されます。

HTTP 要求は、HEAD メソッドを使用して行われます。 カスタム データ コネクタ コンテキストの外部では、(セキュリティ上の理由から) 応答ヘッダーのサブセットのみを使用できます。

例 1

RelativePath およびクエリ オプションを使用して、"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
])