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 行のデータが挿入されます。

要求

以下は、要求の例です。

HTTP

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]
  ]"
}

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const workbookTableRow = {
  values: "[
    [1, 2, 3],
    [4, 5, 6]
  ]"
};

await client.api('/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows')
    .version('beta')
    .post(workbookTableRow);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var workbookTableRow = new WorkbookTableRow
{
    Values = JsonDocument.Parse(@"""[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]""")
};

await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows
    .Request()
    .Header("Prefer","respond-async")
    .Header("Workbook-Session-Id","{Workbook-Session-Id}")
    .AddAsync(workbookTableRow);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"respond-async" forHTTPHeaderField:@"Prefer"];
[urlRequest setValue:@"{Workbook-Session-Id}" forHTTPHeaderField:@"Workbook-Session-Id"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphWorkbookTableRow *workbookTableRow = [[MSGraphWorkbookTableRow alloc] init];
[workbookTableRow setValues:@"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]"];

NSError *error;
NSData *workbookTableRowData = [workbookTableRow getSerializedDataWithError:&error];
[urlRequest setHTTPBody:workbookTableRowData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new HeaderOption("Prefer", "respond-async"));
requestOptions.add(new HeaderOption("Workbook-Session-Id", "{Workbook-Session-Id}"));

WorkbookTableRow workbookTableRow = new WorkbookTableRow();
workbookTableRow.values = JsonParser.parseString("\"[\r\n    [1, 2, 3],\r\n    [4, 5, 6]\r\n  ]\"");

graphClient.me().drive().items("01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ").workbook().tables("Table1").rows()
    .buildRequest( requestOptions )
    .post(workbookTableRow);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

以下は、応答の例です。

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

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 つの要求を発行する必要があります。この要求、 ブックの操作の取得、および必要に応じて Get 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]
  ]"
}

応答

非同期操作につながる応答のもう 1 つの例を次に示します。 詳細については 、「Get workbookOperation and 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

{
}