Office.MasterCategories interface

メールボックスのカテゴリマスターリストを表します。

Outlook では、ユーザーはカテゴリを使用して色分けすることで、メッセージや予定にタグを付けることができます。ユーザーは自分のメールボックスのマスターリストにカテゴリを定義します。その後、アイテムに 1 つ以上のカテゴリを適用できます。

重要: デリゲートまたは共有シナリオでは、デリゲートはマスターリスト内のカテゴリを取得できますが、カテゴリを追加または削除することはできません。

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

使用元

Office.Mailbox: masterCategories

メソッド

addAsync(categories, options, callback)	メールボックスのマスターリストにカテゴリを追加します。各カテゴリには一意の名前が必要ですが、複数のカテゴリで同じ色を使用できます。
addAsync(categories, callback)	メールボックスのマスターリストにカテゴリを追加します。各カテゴリには一意の名前が必要ですが、複数のカテゴリで同じ色を使用できます。
getAsync(options, callback)	メールボックス上のカテゴリのマスターリストを取得します。
getAsync(callback)	メールボックス上のカテゴリのマスターリストを取得します。
removeAsync(categories, options, callback)	メールボックスのマスターリストからカテゴリを削除します。
removeAsync(categories, callback)	メールボックスのマスターリストからカテゴリを削除します。

addAsync(categories, options, callback)

メールボックスのマスターリストにカテゴリを追加します。各カテゴリには一意の名前が必要ですが、複数のカテゴリで同じ色を使用できます。

addAsync(categories: CategoryDetails[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

categories: Office.CategoryDetails[]

メールボックスのマスターリストに追加するカテゴリ。

options: Office.AsyncContextOptions

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

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

エラー:

DuplicateCategory : 指定されたカテゴリの 1 つが既にマスターカテゴリリストに含まれています。
PermissionDenied : ユーザーには、このアクションを実行する権限がありません。

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

const masterCategoriesToAdd = [
  {
    displayName: "TestCategory",
    color: Office.MailboxEnums.CategoryColor.Preset0
  }
];

Office.context.mailbox.masterCategories.addAsync(masterCategoriesToAdd, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Successfully added categories to master list");
  } else {
    console.log("masterCategories.addAsync call failed with error: " + asyncResult.error.message);
  }
});

addAsync(categories, callback)

メールボックスのマスターリストにカテゴリを追加します。各カテゴリには一意の名前が必要ですが、複数のカテゴリで同じ色を使用できます。

addAsync(categories: CategoryDetails[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

パラメーター

categories: Office.CategoryDetails[]

メールボックスのマスターリストに追加するカテゴリ。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

エラー:

DuplicateCategory : 指定されたカテゴリの 1 つが既にマスターカテゴリリストに含まれています。
PermissionDenied : ユーザーには、このアクションを実行する権限がありません。

getAsync(options, callback)

メールボックス上のカテゴリのマスターリストを取得します。

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

パラメーター

options: Office.AsyncContextOptions

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

callback: (asyncResult: Office.AsyncResult<Office.CategoryDetails[]>) => void

メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。分類の追加に失敗した場合、 asyncResult.error プロパティにエラーコードが含まれます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

getAsync(callback)

メールボックス上のカテゴリのマスターリストを取得します。

getAsync(callback: (asyncResult: Office.AsyncResult<CategoryDetails[]>) => void): void;

パラメーター

callback: (asyncResult: Office.AsyncResult<Office.CategoryDetails[]>) => void

メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

Office.context.mailbox.masterCategories.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const categories = asyncResult.value;
    if (categories && categories.length > 0) {
      console.log("Master categories:");
      console.log(JSON.stringify(categories));
    } else {
      console.log("There are no categories in the master list.");
    }
  } else {
    console.error(asyncResult.error);
  }
});

removeAsync(categories, options, callback)

メールボックスのマスターリストからカテゴリを削除します。

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

パラメーター

categories: string[]

メールボックスのマスターリストから削除するカテゴリ。

options: Office.AsyncContextOptions

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

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。カテゴリの削除に失敗した場合、 asyncResult.error プロパティにはエラーコードが含まれます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

エラー:

PermissionDenied : ユーザーには、このアクションを実行する権限がありません。

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

const masterCategoriesToRemove = ["TestCategory"];

Office.context.mailbox.masterCategories.removeAsync(masterCategoriesToRemove, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Successfully removed categories from master list");
  } else {
    console.log("masterCategories.removeAsync call failed with error: " + asyncResult.error.message);
  }
});

removeAsync(categories, callback)

メールボックスのマスターリストからカテゴリを削除します。

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

パラメーター

categories: string[]

メールボックスのマスターリストから削除するカテゴリ。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。カテゴリの削除に失敗した場合、 asyncResult.error プロパティにはエラーコードが含まれます。

返品

void

注釈

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

最小アクセス許可レベル: メールボックスの読み取り/書き込み

適用可能な Outlook モード: Composeまたは読み取り

エラー:

PermissionDenied : ユーザーには、このアクションを実行する権限がありません。

注釈

使用元

メソッド

メソッドの詳細

addAsync(categories, options, callback)

パラメーター

返品

注釈

例

addAsync(categories, callback)

パラメーター

返品

注釈

getAsync(options, callback)

パラメーター

返品

注釈

getAsync(callback)

パラメーター

返品

注釈

例

removeAsync(categories, options, callback)

パラメーター

返品

注釈

例

removeAsync(categories, callback)

パラメーター

返品

注釈

フィードバック