Office.InternetHeaders interface

オブジェクトは InternetHeaders 、メッセージ 項目が Exchange から離れた後に保持され、MIME メッセージに変換されるカスタム インターネット ヘッダーを表します。

インターネット ヘッダーは、アイテムごとに文字列キーと値のペアとして格納されます。

: このオブジェクトは、メッセージ項目にカスタム ヘッダーを設定して取得することを目的としています。 詳細については、「Outlook アドインのメッセージにインターネット ヘッダーを取得して設定する」を参照してください。

注釈

[ API セット: メールボックス 1.8 ]

推奨プラクティス

現在、インターネット ヘッダーは、ユーザーのメールボックス上の有限リソースです。 クォータが不足すると、そのメールボックスにインターネット ヘッダーをこれ以上作成できないため、この機能に依存するクライアントから予期しない動作が発生する可能性があります。

アドインでインターネット ヘッダーを作成する場合は、次のガイドラインを適用します。

  • 必要なヘッダーの最小数を作成します。 ヘッダー クォータは、メッセージに適用されるヘッダーの合計サイズに基づいています。 Exchange Onlineでは、ヘッダーの上限は 256 KB ですが、Exchange オンプレミス環境では、organizationの管理者によって制限が決定されます。 ヘッダーの制限の詳細については、「Exchange Online メッセージ制限とメッセージ制限Exchange Server」を参照してください。

  • 後で値を再利用して更新できるように、ヘッダーに名前を付けます。 そのため、(ユーザー入力やタイムスタンプなどに基づくなど) 可変の方法でヘッダーに名前を付けるのは避けてください。

最小アクセス許可レベル: アイテムの読み取り

適用できる Outlook モード: 新規作成

メソッド

getAsync(names, options, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドは、これらのインターネット ヘッダーとその値を含むレコードを返します。 アドインが使用できないヘッダーを要求した場合、そのヘッダーは結果に返されません。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーの値を setAsync 返すことを目的としています。

getAsync(names, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドは、これらのインターネット ヘッダーとその値を含むレコードを返します。 アドインが使用できないヘッダーを要求した場合、そのヘッダーは結果に返されません。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーの値を setAsync 返すことを目的としています。

removeAsync(names, options, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドはインターネット ヘッダー コレクションから指定されたヘッダーを削除します。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーを setAsync 削除することを目的としています。

removeAsync(names, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドはインターネット ヘッダー コレクションから指定されたヘッダーを削除します。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーを setAsync 削除することを目的としています。

setAsync(headers, options, callback)

指定したインターネット ヘッダーを指定した値に設定します。

指定したヘッダーがまだ存在しない場合は setAsync 、メソッドによって新しいヘッダーが作成されます。それ以外の場合は、既存の値が新しい値に置き換えられます。

: このメソッドは、カスタム ヘッダーの値を設定することを目的としています。

重要: ヘッダー クォータは、メッセージに適用されるヘッダーの合計サイズに基づいています。 Exchange Onlineでは、ヘッダーの上限は 256 KB ですが、Exchange オンプレミス環境では、organizationの管理者によって制限が決定されます。 ヘッダーの制限の詳細については、「Exchange Online メッセージ制限とメッセージ制限Exchange Server」を参照してください。

setAsync(headers, callback)

指定したインターネット ヘッダーを指定した値に設定します。

指定したヘッダーがまだ存在しない場合は setAsync 、メソッドによって新しいヘッダーが作成されます。それ以外の場合は、既存の値が新しい値に置き換えられます。

: このメソッドは、カスタム ヘッダーの値を設定することを目的としています。

重要: ヘッダー クォータは、メッセージに適用されるヘッダーの合計サイズに基づいています。 Exchange Onlineでは、ヘッダーの上限は 256 KB ですが、Exchange オンプレミス環境では、organizationの管理者によって制限が決定されます。 ヘッダーの制限の詳細については、「Exchange Online メッセージ制限とメッセージ制限Exchange Server」を参照してください。

メソッドの詳細

getAsync(names, options, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドは、これらのインターネット ヘッダーとその値を含むレコードを返します。 アドインが使用できないヘッダーを要求した場合、そのヘッダーは結果に返されません。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーの値を setAsync 返すことを目的としています。

getAsync(names: string[], options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<Record<string, string>>) => void): void;

パラメーター

names

string[]

返されるインターネット ヘッダーの名前。

options
Office.AsyncContextOptions

次のプロパティの 1 つ以上を含むオブジェクト リテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。

callback

(asyncResult: Office.AsyncResult<Record<string, string>>) => void

メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 インターネット ヘッダーの文字列キーと値のペアが プロパティで asyncResult.value 返されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: アイテムの読み取り

適用できる Outlook モード: 新規作成

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/70-mime-headers/manage-custom-internet-headers-message-compose.yaml

Office.context.mailbox.item.internetHeaders.getAsync(
  ["preferred-fruit", "preferred-vegetable", "best-vegetable", "nonexistent-header"],
  function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
      console.log("Selected headers: " + JSON.stringify(asyncResult.value));
    } else {
      console.log("Error getting selected headers: " + JSON.stringify(asyncResult.error));
    }
  }
);

getAsync(names, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドは、これらのインターネット ヘッダーとその値を含むレコードを返します。 アドインが使用できないヘッダーを要求した場合、そのヘッダーは結果に返されません。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーの値を setAsync 返すことを目的としています。

getAsync(names: string[], callback: (asyncResult: Office.AsyncResult<Record<string, string>>) => void): void;

パラメーター

names

string[]

返されるインターネット ヘッダーの名前。

callback

(asyncResult: Office.AsyncResult<Record<string, string>>) => void

メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 インターネット ヘッダーの文字列キーと値のペアが プロパティで asyncResult.value 返されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: アイテムの読み取り

適用できる Outlook モード: 新規作成

removeAsync(names, options, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドはインターネット ヘッダー コレクションから指定されたヘッダーを削除します。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーを setAsync 削除することを目的としています。

removeAsync(names: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

names

string[]

削除するインターネット ヘッダーの名前。

options
Office.AsyncContextOptions

次のプロパティの 1 つ以上を含むオブジェクト リテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。

callback

(asyncResult: Office.AsyncResult<void>) => void

オプション。 メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 項目の読み取り/書き込み

適用できる Outlook モード: 新規作成

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/70-mime-headers/manage-custom-internet-headers-message-compose.yaml

Office.context.mailbox.item.internetHeaders.removeAsync(
  ["best-vegetable", "nonexistent-header"],
  function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
      console.log("Successfully removed selected headers");
    } else {
      console.log("Error removing selected headers: " + JSON.stringify(asyncResult.error));
    }
  }
);

removeAsync(names, callback)

インターネット ヘッダー名の配列を指定すると、このメソッドはインターネット ヘッダー コレクションから指定されたヘッダーを削除します。

: このメソッドは、 メソッドを使用して設定したカスタム ヘッダーを setAsync 削除することを目的としています。

removeAsync(names: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

names

string[]

削除するインターネット ヘッダーの名前。

callback

(asyncResult: Office.AsyncResult<void>) => void

オプション。 メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 項目の読み取り/書き込み

適用できる Outlook モード: 新規作成

setAsync(headers, options, callback)

指定したインターネット ヘッダーを指定した値に設定します。

指定したヘッダーがまだ存在しない場合は setAsync 、メソッドによって新しいヘッダーが作成されます。それ以外の場合は、既存の値が新しい値に置き換えられます。

: このメソッドは、カスタム ヘッダーの値を設定することを目的としています。

重要: ヘッダー クォータは、メッセージに適用されるヘッダーの合計サイズに基づいています。 Exchange Onlineでは、ヘッダーの上限は 256 KB ですが、Exchange オンプレミス環境では、organizationの管理者によって制限が決定されます。 ヘッダーの制限の詳細については、「Exchange Online メッセージ制限とメッセージ制限Exchange Server」を参照してください。

setAsync(headers: Record<string, string>, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

headers

Record<string, string>

設定するヘッダーの名前と対応する値。 これは、キーがインターネット ヘッダー名であり、値が対応するヘッダー値文字列であるレコード オブジェクトである必要があります。

options
Office.AsyncContextOptions

次のプロパティの 1 つ以上を含むオブジェクト リテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。

callback

(asyncResult: Office.AsyncResult<void>) => void

オプション。 メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 項目の読み取り/書き込み

適用できる Outlook モード: 新規作成

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/70-mime-headers/manage-custom-internet-headers-message-compose.yaml

Office.context.mailbox.item.internetHeaders.setAsync(
  { "preferred-fruit": "orange", "preferred-vegetable": "broccoli", "best-vegetable": "spinach" },
  function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
      console.log("Successfully set headers");
    } else {
      console.log("Error setting headers: " + JSON.stringify(asyncResult.error));
    }
  }

);

setAsync(headers, callback)

指定したインターネット ヘッダーを指定した値に設定します。

指定したヘッダーがまだ存在しない場合は setAsync 、メソッドによって新しいヘッダーが作成されます。それ以外の場合は、既存の値が新しい値に置き換えられます。

: このメソッドは、カスタム ヘッダーの値を設定することを目的としています。

重要: ヘッダー クォータは、メッセージに適用されるヘッダーの合計サイズに基づいています。 Exchange Onlineでは、ヘッダーの上限は 256 KB ですが、Exchange オンプレミス環境では、organizationの管理者によって制限が決定されます。 ヘッダーの制限の詳細については、「Exchange Online メッセージ制限とメッセージ制限Exchange Server」を参照してください。

setAsync(headers: Record<string, string>, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

headers

Record<string, string>

設定するヘッダーの名前と対応する値。 これは、キーがインターネット ヘッダー名であり、値が対応するヘッダー値文字列であるレコード オブジェクトである必要があります。

callback

(asyncResult: Office.AsyncResult<void>) => void

オプション。 メソッドが完了すると、 パラメーターでcallback渡された関数が、 型Office.AsyncResultの 1 つのパラメーター asyncResultである を使用して呼び出されます。 エラーが発生した場合は、 プロパティで指定 asyncResult.error します。

戻り値

void

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 項目の読み取り/書き込み

適用できる Outlook モード: 新規作成