メインコンテンツまでスキップ

Web.Headers

URL からダウンロードされた HTTP ヘッダーをレコード値として返します。

Syntax​

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

Remarks​

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

  • Query : エスケープを気にせずに、URL にクエリ パラメーターをプログラムで追加します。
  • ApiKeyName : ターゲット サイトに API キーの表記がある場合は、このパラメーターを使用して、URL で使用する必要のあるキー パラメーターの名前 (値ではなく) を指定できます。実際のキー値は資格情報で提供されます。
  • Headers : この値をレコードとして指定すると、HTTP 要求に追加ヘッダーが提供されます。
  • Timeout : この値を期間として指定すると、HTTP 要求のタイムアウトが変更されます。既定値は 100 秒です。
  • ExcludedFromCacheKey : この値を一覧として指定すると、これらの HTTP ヘッダー キーが、データをキャッシュするための計算から除外されます。
  • IsRetry : この論理値を true に指定すると、データをフェッチするときに、キャッシュ内の既存の応答が無視されます。
  • ManualStatusHandling : この値を一覧として指定すると、応答にこれらの状態コードのいずれかが含まれる HTTP 要求で、組み込み処理が回避されます。
  • RelativePath : この値をテキストとして指定すると、要求を作成する前にベース URL に追加されます。
HTTP 要求は HEAD メソッドを使用して行われます。カスタム データ コネクタ コンテキストの外部では、(セキュリティ上の理由から) 応答ヘッダーのサブセットのみが使用できます。

Examples​

Example #1​

RelativePath オプションと Query オプションを使用して、 <code>"https://bing.com/search?q=Power+Query&#34;&lt;/code> の HTTP ヘッダーを取得します。

let
    searchText = "Power Query"
in
    Web.Headers(
        "https://www.bing.com",
        [
            RelativePath = "search",
            Query = [q = searchText]
        ]
    )

Result:

([
    #"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
])

Category​

Accessing data