Diese Seite wurde von der Cloud Translation API übersetzt.

REST Resource: drives

Ressource: Drive
- JSON-Darstellung
Methoden

Ressource: Drive

Darstellung einer geteilten Ablage

Für einige Ressourcenmethoden (z. B. drives.update) ist ein driveId erforderlich. Verwenden Sie die Methode drives.list, um die ID für eine geteilte Ablage abzurufen.

JSON-Darstellung
{ "id": string, "name": string, "colorRgb": string, "kind": string, "backgroundImageLink": string, "capabilities": { "canAddChildren": boolean, "canComment": boolean, "canCopy": boolean, "canDeleteDrive": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canManageMembers": boolean, "canReadRevisions": boolean, "canRename": boolean, "canRenameDrive": boolean, "canChangeDriveBackground": boolean, "canShare": boolean, "canChangeCopyRequiresWriterPermissionRestriction": boolean, "canChangeDomainUsersOnlyRestriction": boolean, "canChangeDriveMembersOnlyRestriction": boolean, "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean, "canResetDriveRestrictions": boolean, "canDeleteChildren": boolean, "canTrashChildren": boolean }, "themeId": string, "backgroundImageFile": { "id": string, "xCoordinate": number, "yCoordinate": number, "width": number }, "createdTime": string, "hidden": boolean, "restrictions": { "copyRequiresWriterPermission": boolean, "domainUsersOnly": boolean, "driveMembersOnly": boolean, "adminManagedRestrictions": boolean, "sharingFoldersRequiresOrganizerPermission": boolean }, "orgUnitId": string }

JSON-Darstellung

{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}

Felder
`id`	`string` Nur Ausgabe Die ID dieser geteilten Ablage, die auch die ID des übergeordneten Ordners dieser geteilten Ablage ist.
`name`	`string` Der Name dieser geteilten Ablage.
`colorRgb`	`string` Die Farbe dieser geteilten Ablage als hexadezimaler RGB-String. Er kann nur für eine `drive.drives.update`-Anfrage festgelegt werden, für die `themeId` nicht festgelegt ist.
`kind`	`string` Nur Ausgabe Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String `"drive#drive"`.
`backgroundImageLink`	`string` Nur Ausgabe Ein kurzlebiger Link zum Hintergrundbild dieser geteilten Ablage.
`capabilities`	`object` Nur Ausgabe Berechtigungen des aktuellen Nutzers in dieser geteilten Ablage.
`capabilities.canAddChildren`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer untergeordnete Elemente zu Ordnern in dieser geteilten Ablage hinzufügen kann.
`capabilities.canComment`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage kommentieren darf.
`capabilities.canCopy`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage kopieren darf.
`capabilities.canDeleteDrive`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer diese geteilte Ablage löschen kann. Der Versuch, die geteilte Ablage zu löschen, kann trotzdem fehlschlagen, wenn sich in der geteilten Ablage Elemente aus dem Papierkorb befinden.
`capabilities.canDownload`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage herunterladen darf.
`capabilities.canEdit`	`boolean` Nur Ausgabe Ob der aktuelle Nutzer Dateien in dieser geteilten Ablage bearbeiten darf
`capabilities.canListChildren`	`boolean` Nur Ausgabe Ob der aktuelle Nutzer die untergeordneten Elemente von Ordnern in dieser geteilten Ablage auflisten darf.
`capabilities.canManageMembers`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer dieser geteilten Ablage Mitglieder hinzufügen, sie entfernen oder ihre Rolle ändern darf.
`capabilities.canReadRevisions`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Ressource für Überarbeitungen von Dateien in dieser geteilten Ablage lesen kann.
`capabilities.canRename`	`boolean` Nur Ausgabe Ob der aktuelle Nutzer Dateien oder Ordner in dieser geteilten Ablage umbenennen kann.
`capabilities.canRenameDrive`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer diese geteilte Ablage umbenennen kann.
`capabilities.canChangeDriveBackground`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer den Hintergrund dieser geteilten Ablage ändern kann.
`capabilities.canShare`	`boolean` Nur Ausgabe Ob der aktuelle Nutzer Dateien oder Ordner in dieser geteilten Ablage freigeben darf.
`capabilities.canChangeCopyRequiresWriterPermissionRestriction`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Einschränkung „`copyRequiresWriterPermission`“ dieser geteilten Ablage ändern kann.
`capabilities.canChangeDomainUsersOnlyRestriction`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Einschränkung „`domainUsersOnly`“ dieser geteilten Ablage ändern kann.
`capabilities.canChangeDriveMembersOnlyRestriction`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Einschränkung „`driveMembersOnly`“ dieser geteilten Ablage ändern kann.
`capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Einschränkung „`sharingFoldersRequiresOrganizerPermission`“ dieser geteilten Ablage ändern kann.
`capabilities.canResetDriveRestrictions`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer die Einschränkungen für geteilte Ablagen auf die Standardeinstellungen zurücksetzen kann.
`capabilities.canDeleteChildren`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer untergeordnete Elemente aus Ordnern in dieser geteilten Ablage löschen darf.
`capabilities.canTrashChildren`	`boolean` Nur Ausgabe Gibt an, ob der aktuelle Nutzer untergeordnete Elemente aus Ordnern in dieser geteilten Ablage in den Papierkorb verschieben darf.
`themeId`	`string` Die ID des Designs, aus dem das Hintergrundbild und die Farbe festgelegt werden. Der Satz der möglichen `driveThemes` kann aus einer `drive.about.get`-Antwort abgerufen werden. Ist dies nicht in einer `drive.drives.create`-Anfrage angegeben, wird ein zufälliges Design für das Hintergrundbild und die -farbe ausgewählt. Dieses Feld ist schreibgeschützt. Es kann nur für Anfragen festgelegt werden, für die nicht `colorRgb` oder `backgroundImageFile` festgelegt ist.
`backgroundImageFile`	`object` Eine Bilddatei und Zuschnittparameter, anhand derer ein Hintergrundbild für diese geteilte Ablage erstellt wird. Dies ist ein schreibgeschütztes Feld. Es kann nur für `drive.drives.update`-Anfragen festgelegt werden, für die `themeId` nicht festgelegt ist. Wenn angegeben, müssen alle Felder von `backgroundImageFile` festgelegt werden.
`backgroundImageFile.id`	`string` Die ID einer Bilddatei in Google Drive, die für das Hintergrundbild verwendet werden soll.
`backgroundImageFile.xCoordinate`	`number` Die X-Koordinate der oberen linken Ecke des Zuschnittbereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht dem horizontalen Abstand von der linken Seite des gesamten Bilds zur linken Seite des Zuschneidebereichs, geteilt durch die Breite des gesamten Bilds.
`backgroundImageFile.yCoordinate`	`number` Die Y-Koordinate der oberen linken Ecke des Zuschnittbereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht dem vertikalen Abstand von der oberen Seite des gesamten Bilds zur oberen Seite des Zuschneidebereichs, geteilt durch die Höhe des gesamten Bilds.
`backgroundImageFile.width`	`number` Die Breite des zugeschnittenen Bilds im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht der Breite des zugeschnittenen Bildes geteilt durch die Breite des gesamten Bildes. Die Höhe wird berechnet, indem ein Breite-zu-Höhe-Seitenverhältnis von 80:9 angewendet wird. Das entstehende Bild muss mindestens 1.280 Pixel breit und 144 Pixel hoch sein.
`createdTime`	`string` Nur Ausgabe Der Zeitpunkt, zu dem die geteilte Ablage erstellt wurde (Datum-Uhrzeit nach RFC 3339).
`hidden`	`boolean` Gibt an, ob die geteilte Ablage in der Standardansicht ausgeblendet ist.
`restrictions`	`object` Für diese geteilte Ablage oder für Elemente in dieser geteilten Ablage gelten Einschränkungen. Hinweis: Beim Erstellen einer geteilten Ablage können keine Einschränkungen festgelegt werden. Wenn Sie eine Einschränkung hinzufügen möchten, erstellen Sie zuerst eine geteilte Ablage und legen Sie dann über `drives.update` Einschränkungen fest.
`restrictions.copyRequiresWriterPermission`	`boolean` Die Optionen zum Kopieren, Drucken und Herunterladen von Dateien in dieser geteilten Ablage sollten für Leser und Kommentatoren deaktiviert werden. Wenn für diese Einschränkung „`true`“ festgelegt ist, wird das Feld mit der Bezeichnung „`true`“ für alle Dateien in dieser geteilten Ablage überschrieben.
`restrictions.domainUsersOnly`	`boolean` Gibt an, ob der Zugriff auf diese geteilte Ablage und die Elemente in der geteilten Ablage auf Nutzer der Domain beschränkt ist, zu der sie gehört. Diese Einschränkung kann durch andere Freigaberichtlinien überschrieben werden, die außerhalb dieser geteilten Ablage verwaltet werden.
`restrictions.driveMembersOnly`	`boolean` Gibt an, ob der Zugriff auf Elemente in dieser geteilten Ablage auf Mitglieder beschränkt ist.
`restrictions.adminManagedRestrictions`	`boolean` Gibt an, ob zum Ändern von Einschränkungen Administratorberechtigungen für diese geteilte Ablage erforderlich sind.
`restrictions.sharingFoldersRequiresOrganizerPermission`	`boolean` Bei „true“ können nur Nutzer mit der Rolle „Organisator“ Ordner freigeben. Bei „false“ können Nutzer mit der Rolle „Organisator“ oder der Rolle „Dateiorganisator“ Ordner freigeben.
`orgUnitId`	`string` Nur Ausgabe Die Organisationseinheit dieser geteilten Ablage. Dieses Feld wird nur bei `drives.list`-Antworten ausgefüllt, wenn der Parameter `useDomainAdminAccess` auf `true` festgelegt ist.

Methoden
`create`	Eine geteilte Ablage wird erstellt.
`delete`	Eine geteilte Ablage, deren `organizer` der Nutzer ist, werden endgültig gelöscht.
`get`	Ruft die Metadaten einer geteilten Ablage nach ID ab.
`hide`	Blendet eine geteilte Ablage aus der Standardansicht aus.
`list`	Listet die geteilten Ablagen des Nutzers auf.
`unhide`	Die Standardansicht einer geteilten Ablage wird wiederhergestellt.
`update`	Damit werden die Metadaten für eine geteilte Ablage aktualisiert.

REST Resource: drives

Ressource: Drive

Methoden

`create`

`delete`

`get`

`hide`

`list`

`unhide`

`update`