workbook: tableRowOperationResult

名前空間: microsoft.graph

この関数は、 workbookTableRow リソースを非同期的に作成する一連の手順の最後です。

複数のテーブル行を作成するベスト プラクティスは、それらを 1 つの tableRow 作成 操作でバッチ処理し、非同期的に操作を実行することです。

テーブル行を作成するための非同期要求には、次の手順が含まれます。

  1. 非同期の Create tableRow 要求を発行し、応答ヘッダーで返されるクエリ URL を Location 取得します。
  2. 手順 1 から返されたクエリ URL を使用して 、Get workbookOperation 要求を発行し、手順 3 の操作 ID を取得します。 または、便宜上、operationStatus の結果をsucceeded取得した後、応答で返された workbookOperationresourceLocation プロパティからクエリ URL を取得し、クエリ URL を手順 3 に適用できます。
  3. 手順 2 から返されたクエリ URL を、この関数 tableRowOperationResult の GET 要求 URL として使用します。 関数呼び出しが成功すると、 workbookTableRow リソース内の新しいテーブル行が返されます。

この関数は、個別に呼び出された場合は何も行いません。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Files.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

HTTP 要求

GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})

関数パラメーター

要求 URL には、次のクエリ パラメーターが必要です。

パラメーター 説明
キー String 前の Get workbookOperation 要求で返された workbookOperation 応答で指定された operationId

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Workbook-Session-Id 変更を永続化するかどうかを決定するブック セッション ID。 省略可能。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、この関数は 200 OK 応答コードと、応答本文の workbookTableRow オブジェクトを返します。

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "index": 99,
  "values": "[[1, 2, 3]]"
}