workbookOperation を取得する
名前空間: microsoft.graph
この URL が個別に呼び出される場合は意味がありません。 この要求は、Excel のすべての非同期要求の一部です。 これは、 workbookOperation オブジェクトの状態を取得するために使用されます。
現時点では、すべての要求で非同期がサポートされているわけではありません。 例として、セッション要求の作成を取ります。
非同期の セッションの作成 要求を発行し、ドキュメントに従って状態コード 202 Acceptedを取得できます。非同期操作はここから開始され、このドキュメントに必要な URL は、 場所 の部分から応答ヘッダーから見つけることができます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Files.ReadWrite | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
GET /me/drive/items/{id}/workbook/operations/{operation-id}
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| Workbook-Session-Id | 変更を永続化するかどうかを決定するブック セッション ID。 省略可能です。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で要求された workbookOperation オブジェクトを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/me/drive/items/{drive-item-id}/workbook/operations/{operation-id}
応答
応答の実行
状態が の応答を次に running示します。 この状態になったら、同じ応答が返されないまで要求を再度ポーリングします。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "running"
}
応答が成功しました
状態が の応答を次に succeeded示します。
resourceLocation は、元の実行時間の長い操作の戻り値を表す URL のグループです。
resourceLocation プロパティから結果を取得する方法の詳細については、次の表を参照してください。
| 操作 | resourceLocation |
|---|---|
| セッションを作成する | sessionInfoResource |
| tableRow を作成する | tableRowOperationResult |
| テーブルの削除Row | resourceLocation は必要ありません。 |
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "succeeded",
"resourceLocation":"https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/sessionInfoResource(key='0195cfac-bd22-4f91-b276-dece0aa2378b')?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ=="
}
応答に失敗しました
状態が の応答を次に failed示します。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0195cfac-bd22-4f91-b276-dece0aa2378b",
"status": "failed",
"error":
{
"code": "internalServerError",
"message": "An internal server error occurred while processing the request.",
"innerError": {
"code": ""internalServerErrorUncategorized",
"message": "An unspecified error has occurred.",
"innerError": {
"code": "GenericFileOpenError",
"message": "The workbook cannot be opened."
}
}
}
}