Range: UsedRange
Namespace: microsoft.graph
Gibt den verwendeten Bereich des angegebenen Bereichsobjekts zurück.
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/usedRange
GET /me/drive/root:/{item-path}:/workbook/names/{name}/range/usedRange
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/usedRange
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/usedRange
GET /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/usedRange
GET /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/usedRange
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
Parameter | Typ | Beschreibung |
---|---|---|
valuesOnly | boolean | Optional. Betrachtet nur Zellen mit Werten als verwendet. |
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/usedRange
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"
}
Hier ist ein Beispiel, das den optionalen valuesOnly
Parameter angibt.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/usedRange(valuesOnly=true)
Antwort
HTTP/1.1 200 OK
Content-type: application/json
{
"address": "address-value",
"addressLocal": "addressLocal-value",
"cellCount": 90,
"columnCount": 90,
"columnIndex": 90,
"valueTypes": "valueTypes-value"
}