workbook: tableRowOperationResult
Namespace: microsoft.graph
Diese Funktion ist der 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 Create tableRow-Vorgang in Batches zu stapeln und den Vorgang asynchron auszuführen.
Eine asynchrone Anforderung zum Erstellen von Tabellenzeilen umfasst die folgenden Schritte:
- Geben Sie eine asynchrone Create tableRow-Anforderung aus, und rufen Sie die abfrage-URL ab, die
Location
im Antwortheader zurückgegeben wird. - Verwenden Sie die aus Schritt 1 zurückgegebene Abfrage-URL, um die Anforderung "workbookOperation abrufen " auszugeben und die Vorgangs-ID für Schritt 3 abzurufen.
Alternativ können Sie nach dem Abrufen eines
succeeded
operationStatus-Ergebnisses die Abfrage-URL aus der resourceLocation-Eigenschaft des in der Antwort zurückgegebenen workbookOperation abrufen und die Abfrage-URL auf Schritt 3 anwenden. - Verwenden Sie die aus Schritt 2 zurückgegebene Abfrage-URL als GET-Anforderungs-URL für diese FunktionstabelleRowOperationResult. Ein erfolgreicher Funktionsaufruf gibt die neuen Tabellenzeilen in einer workbookTableRow-Ressource zurück.
Diese Funktion führt nichts aus, wenn sie unabhängig aufgerufen wird.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Files.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Nicht unterstützt | 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 |
---|---|---|
Schlüssel | Zeichenfolge | Die in der workbookOperation-Antwort angegebene operationId, die in der vorherigen Anforderung zum Abrufen von workbookOperation zurückgegeben wurde. |
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Arbeitsmappensitzungs-ID | Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Funktion erfolgreich verläuft, werden der 200 OK
Antwortcode und ein workbookTableRow-Objekt im Antworttext zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
Antwort
Das folgende Beispiel zeigt die 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]]"
}