workbook: tableRowOperationResult

Namespace: microsoft.graph

Diese Funktion ist die letzte in einer Reihe von Schritten zum asynchronen Erstellen einer workbookTableRow-Ressource.

Eine bewährte Methode zum Erstellen mehrerer Tabellenzeilen besteht darin, sie in einem Einzigen TableRow-Vorgang zu stapeln und den Vorgang asynchron auszuführen.

Eine asynchrone Anforderung zum Erstellen von Tabellenzeilen umfasst die folgenden Schritte:

1. Geben Sie eine asynchrone Create tableRow-Anforderung aus, und rufen Sie die Abfrage-URL ab, die im Location Antwortheader zurückgegeben wird.
2. Verwenden Sie die von Schritt 1 zurückgegebene Abfrage-URL, um die Anforderung "WorkbookOperation abrufen" auszustellen und die Vorgangs-ID für Schritt 3 abzurufen. Alternativ können Sie aus Gründen der Einfachheit, nachdem Sie ein succeeded operationStatus-Ergebnis erhalten haben, die Abfrage-URL aus der resourceLocation-Eigenschaft der in der Antwort zurückgegebenen workbookOperation abrufen und die Abfrage-URL auf Schritt 3 anwenden.
3. Verwenden Sie die von Schritt 2 zurückgegebene Abfrage-URL als GET-Anforderungs-URL für diese Funktion tableRowOperationResult. Ein erfolgreicher Funktionsaufruf gibt die neuen Tabellenzeilen in einer workbookTableRow-Ressource zurück.

Diese Funktion führt keine Aktion aus, wenn sie unabhängig aufgerufen wird.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

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

Funktionsparameter

Die Anforderungs-URL erfordert den folgenden Abfrageparameter.

Parameter	Typ	Beschreibung
Key	Zeichenfolge	The operationId provided in the workbookOperation response returned in the preceding Get workbookOperation request.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Arbeitsmappensitzungs-ID	Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Funktion den 200 OK Antwortcode und ein workbookTableRow-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

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

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var workbookTableRow = await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook
    .TableRowOperationResult("0195cfac-bd22-4f91-b276-dece0aa2378b")
    .Request()
    .GetAsync();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

let workbookTableRow = await client.api('/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')')
    .version('beta')
    .get();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

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/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')"]]];
[urlRequest setHTTPMethod:@"GET"];

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

        MSGraphWorkbookTableRow *workbookTableRow = [[MSGraphWorkbookTableRow alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Java

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

WorkbookTableRow workbookTableRow = graphClient.me().drive().items("01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ").workbook()
    .tableRowOperationResult(WorkbookTableRowOperationResultParameterSet
        .newBuilder()
        .withKey("0195cfac-bd22-4f91-b276-dece0aa2378b")
        .build())
    .buildRequest()
    .get();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

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