TableRow を作成する
名前空間: microsoft.graph
テーブルの末尾に行を追加します。
この API では、複数行のデータを受け入れることに注意してください。 一度に 1 行を追加すると、パフォーマンスに影響する可能性があります。 推奨される方法は、1 つの行を挿入するのではなく、1 回の呼び出しで行をバッチ処理することです。 最適な結果を得るには、アプリケーション側に挿入する行を収集し、1 つの行追加操作を実行します。 行数を試して、1 つの API 呼び出しで使用する理想的な行数を決定します。
この要求によってエラーが発生 504 HTTP することがあります。 このエラーに対する適切な対応は、要求を繰り返すことです。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Files.ReadWrite |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | サポートされていません。 |
HTTP 要求
POST /me/drive/items/{id}/workbook/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 |
| Content-Type | application/json. Required. |
| Prefer | respond-async。 要求が非同期要求であることを示します。 オプション。 |
| Workbook-Session-Id | {Workbook-Session-Id}。 createSession 要求から作成されます。 省略可能。 |
要求本文
要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
| index | Int32 | 省略可能。 新しい行の相対位置を指定します。 null の場合、最後に追加が行われます。 挿入した行の下のすべての行が下方向にシフトします。 0 を起点とする番号になります。 |
| values | Json | テーブル行の書式設定されていない値の 2 次元配列。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文に workbookTableRow オブジェクトを返します。
例
例 1: テーブルに 2 つの行を追加する
この例では、テーブルの末尾に 2 行のデータが挿入されます。
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json
{
"values": "[
[1, 2, 3],
[4, 5, 6]
]"
}
応答
以下は、応答の例です。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 201 Created
Content-type: application/json
{
"index": 99,
"values": "[[1, 2, 3]]"
}
例 2: テーブルに 2 つの行を非同期的に追加する
非同期要求は、要求に予想よりも長い時間がかかる場合に便利です。 非同期要求を Workbook-Session-Id 発行する場合は、ヘッダーが必要であることに注意してください。 ユーザーは、非同期リッチ API 機能を使用する前に セッションを作成 する必要があります。 ヘッダー Prefer:respond-async は非同期要求でも必要です。
非同期機能の場合、通常、ユーザーは 2 つまたは 3 つの要求を発行する必要があります。この要求は、 ブックの操作を取得し、必要に応じて tableRowOperationResult を取得します。
要求
非同期要求の例を次に示します。 要求の 202 Accepted 応答に時間がかかる場合にのみ発生します。 要求がすぐに完了すると、通常の同期要求のように動作し、 例 1 にフォールバックします。
POST https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json
Prefer: respond-async
Workbook-Session-Id: {Workbook-Session-Id}
{
"values": "[
[1, 2, 3],
[4, 5, 6]
]"
}
応答
非同期操作につながる応答の別の例を次に示します。 詳細については、「 ブックの取得Operation 」と「 Get tableRowOperationResult」を参照してください。
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/operations/0195cfac-bd22-4f91-b276-dece0aa2378b?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ==
Content-type: application/json
{
}