approvalItem リソースの種類
名前空間: 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"
}