Ressource: Berechtigung
Eine Berechtigung für eine Datei. Eine Berechtigung gewährt einem Nutzer, einer Gruppe, einer Domain oder weltweit Zugriff auf eine Datei- oder Ordnerhierarchie.
Einige Ressourcenmethoden (z. B. permissions.update
) erfordern eine permissionId
. Verwenden Sie die Methode permissions.list
, um die ID für eine Datei, einen Ordner oder eine geteilte Ablage abzurufen.
JSON-Darstellung |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Felder | |
---|---|
id |
Nur Ausgabe Die ID dieser Berechtigung. Dies ist eine eindeutige Kennung für den Empfänger. Sie wird in den Nutzerressourcen als |
displayName |
Nur Ausgabe Der „schöne“ Name des Werts der Berechtigung. Im Folgenden finden Sie eine Liste mit Beispielen für jeden Berechtigungstyp:
|
type |
Typ des Empfängers einer Förderung Gültige Werte sind:
Wenn |
kind |
Nur Ausgabe Gibt an, welche Art von Ressource dies ist. Wert: der feste String |
permissionDetails[] |
Nur Ausgabe Details dazu, ob die Berechtigungen für dieses Element in der geteilten Ablage übernommen werden oder direkt für dieses Element. Dieses Feld dient ausschließlich der Ausgabe und ist nur für Elemente in geteilten Ablagen vorhanden. |
permissionDetails[].permissionType |
Nur Ausgabe Der Berechtigungstyp für diesen Nutzer. In Zukunft können zwar neue Werte hinzugefügt werden, derzeit ist jedoch Folgendes möglich:
|
permissionDetails[].inheritedFrom |
Nur Ausgabe Die ID des Elements, von dem diese Berechtigung übernommen wurde. Dieses Feld dient nur zur Ausgabe. |
permissionDetails[].role |
Nur Ausgabe Die primäre Rolle für diesen Nutzer. In Zukunft werden möglicherweise neue Werte hinzugefügt. Derzeit ist Folgendes möglich:
|
permissionDetails[].inherited |
Nur Ausgabe Gibt an, ob diese Berechtigung übernommen wird. Dieses Feld wird immer ausgefüllt. Dieses Feld dient nur zur Ausgabe. |
photoLink |
Nur Ausgabe Ein Link zum Profilbild des Nutzers, falls verfügbar. |
emailAddress |
Die E-Mail-Adresse des Nutzers oder der Gruppe, auf die sich diese Berechtigung bezieht. |
role |
Die durch diese Berechtigung gewährte Rolle. In Zukunft werden zwar möglicherweise neue Werte unterstützt, derzeit sind jedoch die folgenden zulässig:
|
allowFileDiscovery |
Gibt an, ob die Berechtigung zulässt, dass die Datei über die Suche gefunden wird. Dies gilt nur für Berechtigungen vom Typ |
domain |
Die Domain, auf die sich diese Berechtigung bezieht. |
expirationTime |
Der Zeitpunkt, zu dem diese Berechtigung abläuft (Datum/Uhrzeit gemäß RFC 3339). Für Ablaufzeiten gelten die folgenden Einschränkungen:
|
teamDrivePermissionDetails[] |
Nur Ausgabe Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen |
teamDrivePermissionDetails[] |
Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen |
teamDrivePermissionDetails[] |
Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen |
teamDrivePermissionDetails[] |
Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen |
teamDrivePermissionDetails[] |
Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen |
deleted |
Nur Ausgabe Gibt an, ob das mit dieser Berechtigung verknüpfte Konto gelöscht wurde. Dieses Feld enthält nur Nutzer- und Gruppenberechtigungen. |
view |
Gibt die Ansicht für diese Berechtigung an. Wird nur für Berechtigungen ausgefüllt, die zu einer Ansicht gehören. 'veröffentlicht' ist der einzige unterstützte Wert. |
pendingOwner |
Gibt an, ob das mit dieser Berechtigung verknüpfte Konto ein ausstehender Inhaber ist. Wird nur mit Berechtigungen vom Typ „ |
Methoden |
|
---|---|
|
Erstellt eine Berechtigung für eine Datei oder geteilte Ablage. |
|
Löscht eine Berechtigung. |
|
Ruft eine Berechtigung nach ID ab. |
|
Hier sehen Sie die Berechtigungen für eine Datei oder geteilte Ablage. |
|
Aktualisiert eine Berechtigung mit Patch-Semantik. |