Range: Cell
Namespace: microsoft.graph
Ruft das Bereichsobjekt ab, das die einzelne Zelle basierend auf Zeilen- und Spaltenanzahl enthält. Die Zelle kann sich außerhalb seines übergeordneten Bereichs befinden, solange es im Arbeitsblatt-Raster bleibt. Die zurückgegebene Zelle befindet sich relativ zur obersten linken Zelle des Bereichs.
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) | Files.ReadWrite | Nicht verfügbar. |
Anwendung | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
GET /me/drive/items/{id}/workbook/names/{name}/range/cell
GET /me/drive/root:/{item-path}:/workbook/names/{name}/range/cell
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/cell
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/cell
GET /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/cell
GET /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/cell
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. |
Pfadparameter
Geben Sie im Pfad die folgenden Parameter an.
Parameter | Typ | Beschreibung |
---|---|---|
row | Int32 | Zeilenanzahl der abzurufenden Zelle. Nullindiziert. |
Spalte | Int32 | Spaltenanzahl der abzurufenden Zelle. Nullindiziert. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und das Range-Objekt im Antworttext zurückgegeben.
Beispiel
Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/cell(row=5,column=6)
Antwort
Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.
HTTP/1.1 200 OK
Content-type: application/json
{
"address": "address-value",
"addressLocal": "addressLocal-value",
"cellCount": 99,
"columnCount": 99,
"columnIndex": 99,
"valueTypes": "valueTypes-value"
}