名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
関連付けられた決定、状態、応答など、承認要求を表します。 ユーザーは、新しい承認項目を作成し、送受信された承認項目を表示し、承認項目に対してアクションを実行できます。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | approvalItem コレクション | approvalItem オブジェクトとそのプロパティの一覧を取得します。 |
| Create | approvalItem | 新しい approvalItem オブジェクトを作成します。 |
| Get | approvalItem | approvalItem オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Cancel | なし | 承認項目を取り消します。 承認の所有者は、このエンドポイントをトリガーできます。 |
| 要求を一覧表示する | approvalItemRequest コレクション | approvalItem の approvalItemRequest のコレクションを取得します。 |
| 応答を一覧表示する | approvalItemResponse コレクション | approvalItem の approvalItemResponse のコレクションを取得します。 |
| 応答の作成 | approvalItemResponse | 新しい approvalItemResponse オブジェクトを作成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| allowCancel | ブール型 | 承認項目を取り消すことができるかどうかを示します。 |
| allowEmailNotification | ブール型 | 電子メール通知が有効かどうかを示します。 |
| approvalType | approvalItemType | 承認項目のワークフローの種類。 使用可能な値: basic、basicAwaitAll、custom、customAwaitAll。 必須です。 |
| 承認 | approvalIdentitySet コレクション | 承認項目が最初に割り当てられたプリンシパルの ID。 必須です。 |
| CompletedDateTime | DateTimeOffset | 承認要求の完了日時。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | 承認要求の作成日時。 読み取り専用です。 |
| 説明 | String | 承認要求の説明。 |
| displayName | String | 承認要求の displayName。 必須。 |
| id | String | 承認項目の一意の ID。 読み取り専用です。 |
| owner | approvalIdentitySet | 承認項目を所有するプリンシパルの ID セット。 プリンシパルの代わりに承認項目を作成する場合にのみ、このプロパティの値を指定します。 所有者フィールドが指定されていない場合は、ユーザー コンテキストからのユーザー情報が使用されます。 |
| responsePrompts | String collection | 承認応答プロンプト。 カスタム承認項目を作成する場合にのみ、このプロパティの値を指定します。 カスタム承認項目の場合は、2 つの応答プロンプト文字列を指定します。 既定の応答プロンプトは、"承認" と "拒否" です。 |
| result | String | 結果フィールドには、承認項目が最終的な状態になった後にのみ設定されます。 承認項目の結果は、approvalType に基づいています。 基本承認項目の場合、結果は "承認済み" または "拒否" になります。 カスタム承認項目の場合、結果は 1 つの応答か、セミコロンで区切られた複数の応答のいずれかになります。 読み取り専用。 |
| state | approvalItemState | 承認項目の状態。 使用可能な値: canceled、created、pending、completed。 読み取り専用です。 |
| 見方 | approvalItemViewPoint | ApprovalItem のユーザー ビューポイント データを表します。 データには、承認項目に関するユーザー ロールが含まれます。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| 要求 | approvalItemRequest コレクション | 承認項目の各承認者に対して作成された要求のコレクション。 |
| 応答 | approvalItemResponse コレクション | 承認項目に対して作成された応答のコレクション。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.approvalItem",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"allowEmailNotification": "Boolean",
"approvalType": "String",
"responsePrompts": [
"String"
],
"approvers": [
{
"@odata.type": "microsoft.graph.approvalIdentitySet"
}
],
"state": "String",
"allowCancel": "Boolean",
"createdDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"viewPoint": {
"@odata.type": "microsoft.graph.approvalItemViewPoint"
},
"owner": {
"@odata.type": "microsoft.graph.approvalIdentitySet"
},
"result": "String"
}