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 eine driveId erforderlich. Verwenden Sie die Methode drives.list, um die ID für eine freigegebene 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 }, "createdDate": 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
  },
  "createdDate": 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 Ordners der obersten Ebene dieser geteilten Ablage ist.
`name`	`string` Der Name dieser geteilten Ablage.
`colorRgb`	`string` Die Farbe dieser freigegebenen Ablage als RGB-Hexadezimalstring. Sie kann nur für eine `drive.drives.update`-Anfrage festgelegt werden, bei der `themeId` nicht festgelegt ist.
`kind`	`string` Nur Ausgabe. Dies ist immer `drive#drive`.
`backgroundImageLink`	`string` Nur Ausgabe. Ein kurzlebiger Link zum Hintergrundbild dieser geteilten Ablage.
`capabilities`	`object` Nur Ausgabe. Die Berechtigungen, die der aktuelle Nutzer für diese geteilte Ablage hat.
`capabilities.canAddChildren`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Ordnern in dieser geteilten Ablage untergeordnete Ordner hinzufügen kann.
`capabilities.canComment`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage kommentieren kann.
`capabilities.canCopy`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage kopieren kann.
`capabilities.canDeleteDrive`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese geteilte Ablage löschen kann. Das Löschen der geteilten Ablage kann fehlschlagen, wenn sich darin Elemente befinden, die nicht im Papierkorb abgelegt wurden.
`capabilities.canDownload`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage herunterladen kann.
`capabilities.canEdit`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage bearbeiten kann
`capabilities.canListChildren`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die untergeordneten Ordner in dieser geteilten Ablage auflisten kann.
`capabilities.canManageMembers`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer dieser geteilten Ablage Mitglieder hinzufügen, sie entfernen oder ihre Rolle ändern kann.
`capabilities.canReadRevisions`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Revisionsressource von Dateien in dieser geteilten Ablage lesen kann.
`capabilities.canRename`	`boolean` Nur Ausgabe. Gibt an, 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 umbennen kann.
`capabilities.canChangeDriveBackground`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer den Hintergrund dieser geteilten Ablage ändern kann.
`capabilities.canShare`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien oder Ordner in dieser geteilten Ablage freigeben kann.
`capabilities.canChangeCopyRequiresWriterPermissionRestriction`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die `copyRequiresWriterPermission`-Einschränkung dieser geteilten Ablage ändern kann.
`capabilities.canChangeDomainUsersOnlyRestriction`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die `domainUsersOnly`-Einschränkung dieser geteilten Ablage ändern kann.
`capabilities.canChangeDriveMembersOnlyRestriction`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die `driveMembersOnly`-Einschränkung dieser geteilten Ablage ändern kann.
`capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die `sharingFoldersRequiresOrganizerPermission`-Einschränkung dieser geteilten Ablage ändern kann.
`capabilities.canResetDriveRestrictions`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Einschränkungen für die geteilte Ablage 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 kann.
`capabilities.canTrashChildren`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente aus Ordnern in dieser geteilten Ablage in den Papierkorb verschieben kann.
`themeId`	`string` Die ID des Designs, aus dem das Hintergrundbild und die Hintergrundfarbe festgelegt werden. Die möglichen `driveThemes` können aus einer `drive.about.get`-Antwort abgerufen werden. Wenn in einer `drive.drives.insert`-Anfrage kein Design angegeben ist, wird ein zufälliges Design ausgewählt, aus dem das Hintergrundbild und die Hintergrundfarbe festgelegt werden. Dieses Feld kann nur zum Schreiben verwendet werden. Es kann nur für Anfragen festgelegt werden, für die `colorRgb` oder `backgroundImageFile` nicht festgelegt ist.
`backgroundImageFile`	`object` Eine Bilddatei und Zuschneideparameter, anhand derer ein Hintergrundbild für diese geteilte Ablage festgelegt wird. Dieses Feld kann nur zum Schreiben verwendet werden. Es kann nur in `drive.drives.update`-Anfragen festgelegt werden, in denen `themeId` nicht festgelegt ist. Wenn angegeben, müssen alle Felder der `backgroundImageFile` festgelegt sein.
`backgroundImageFile.id`	`string` Die ID einer Bilddatei in Google Drive, die als Hintergrundbild verwendet werden soll.
`backgroundImageFile.xCoordinate`	`number` Die X-Koordinate der linken oberen Ecke des Zuschneidebereichs 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 Bildes zur linken Seite des Zuschneidebereichs geteilt durch die Breite des gesamten Bildes.
`backgroundImageFile.yCoordinate`	`number` Die Y-Koordinate der linken oberen Ecke des Zuschneidebereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht dem vertikalen Abstand von der Oberseite des gesamten Bildes zur Oberseite des Zuschneidebereichs geteilt durch die Höhe des gesamten Bildes.
`backgroundImageFile.width`	`number` Die Breite des zugeschnittenen Bilds im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht der Breite des zugeschnittenen Bilds geteilt durch die Breite des gesamten Bilds. Die Höhe wird berechnet, indem das Seitenverhältnis von 80:9 angewendet wird. Das resultierende Bild muss mindestens 1.280 Pixel breit und 144 Pixel hoch sein.
`createdDate`	`string` Nur Ausgabe. Die Uhrzeit, zu der die geteilte Ablage erstellt wurde (Datum und Uhrzeit im RFC 3339-Format).
`hidden`	`boolean` Gibt an, ob die geteilte Ablage in der Standardansicht ausgeblendet ist.
`restrictions`	`object` Eine Reihe von Einschränkungen, die für diese geteilte Ablage oder Elemente in dieser geteilten Ablage gelten.
`restrictions.copyRequiresWriterPermission`	`boolean` Ob die Optionen zum Kopieren, Drucken oder Herunterladen von Dateien in dieser geteilten Ablage für Leser und Kommentatoren deaktiviert werden sollen. Wenn diese Einschränkung auf `true` festgelegt ist, wird das entsprechende Feld für alle Dateien in dieser geteilten Ablage überschrieben.`true`
`restrictions.domainUsersOnly`	`boolean` Gibt an, ob der Zugriff auf diese geteilte Ablage und die Elemente darin auf Nutzer der Domain beschränkt ist, zu der diese geteilte Ablage gehört. Diese Einschränkung kann durch andere Freigaberichtlinien überschrieben werden, die außerhalb dieser geteilten Ablage verwaltet werden.
`restrictions.driveMembersOnly`	`boolean` Ob der Zugriff auf Elemente in dieser geteilten Ablage auf ihre Mitglieder beschränkt ist.
`restrictions.adminManagedRestrictions`	`boolean` Ob Administratorberechtigungen für diese geteilte Ablage erforderlich sind, um Einschränkungen zu ändern.
`restrictions.sharingFoldersRequiresOrganizerPermission`	`boolean` Wenn diese Option aktiviert ist, können nur Nutzer mit der Rolle „Organisator“ Ordner freigeben. Wenn „false“ festgelegt ist, können Nutzer mit der Rolle „Veranstalter“ oder „Dateiveranstalter“ Ordner freigeben.
`orgUnitId`	`string` Nur Ausgabe. Die Organisationseinheit dieser geteilten Ablage. Dieses Feld wird nur in `drives.list`-Antworten ausgefüllt, wenn der Parameter `useDomainAdminAccess` auf `true` gesetzt ist.

Methoden
`delete`	Eine geteilte Ablage, für die der Nutzer `organizer` ist, wird endgültig gelöscht.
`get`	Ruft die Metadaten einer geteilten Ablage anhand der ID ab.
`hide`	Eine geteilte Ablage wird in der Standardansicht ausgeblendet.
`insert`	Erstellt eine neue geteilte Ablage.
`list`	Hier werden die geteilten Ablagen des Nutzers aufgeführt.
`unhide`	Stellt die Standardansicht einer geteilten Ablage wieder her.
`update`	Aktualisiert die Metadaten für eine geteilte Ablage.

REST Resource: drives

Ressource: Drive

Methoden

`delete`

`get`

`hide`

`insert`

`list`

`unhide`

`update`