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 wie 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 ist.
`name`	`string` Der Name dieser geteilten Ablage.
`colorRgb`	`string` Die Farbe dieser geteilten Ablage als hexadezimaler RGB-String. Sie kann nur für eine `drive.drives.update`-Anfrage ohne `themeId` festgelegt werden.
`kind`	`string` Nur Ausgabe. Gibt an, um welche Art von Ressource es sich handelt. Wert: fester String `"drive#drive"`.
`backgroundImageLink`	`string` Nur Ausgabe. Ein kurzlebiger Link zum Hintergrundbild dieser geteilten Ablage.
`capabilities`	`object` Nur Ausgabe. Die Berechtigungen des aktuellen Nutzers für diese geteilte Ablage.
`capabilities.canAddChildren`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer den Ordnern in dieser geteilten Ablage Kinder 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 kann.
`capabilities.canDeleteDrive`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese geteilte Ablage löschen kann. Wenn die Elemente in der geteilten Ablage nicht wiederhergestellt wurden, kann der Versuch, sie zu löschen, fehlschlagen.
`capabilities.canDownload`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Dateien in dieser geteilten Ablage herunterladen kann.
`capabilities.canEdit`	`boolean` Nur Ausgabe. 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 der geteilten Ablage auflisten kann.
`capabilities.canManageMembers`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Mitglieder dieser geteilten Ablage hinzufügen oder entfernen oder seine Rolle ändern kann.
`capabilities.canReadRevisions`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Überarbeitungsressource der 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 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. Gibt an, 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 die geteilte Ablage auf die Standardeinstellungen zurücksetzen kann.
`capabilities.canDeleteChildren`	`boolean` Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Kinder 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 löschen kann.
`themeId`	`string` Die ID des Designs, dessen Hintergrundbild und Farbe festgelegt werden. Der Satz möglicher `driveThemes` kann aus einer `drive.about.get`-Antwort abgerufen werden. Wenn nicht in einer `drive.drives.create` Anfrage angegeben, wird ein willkürliches Design ausgewählt, dessen Hintergrund und Farbe festgelegt werden. Dieses Feld ist schreibgeschützt. Es kann nur für Anfragen festgelegt werden, für die nicht `colorRgb` oder `backgroundImageFile` festgelegt ist.
`backgroundImageFile`	`object` Bilddatei und Parameter, aus denen ein Hintergrundbild für diese geteilte Ablage festgelegt wird. Dieses Feld ist schreibgeschützt. Es kann nur für `drive.drives.update`-Anfragen festgelegt werden, bei denen `themeId` nicht festgelegt ist. Wenn dieses Feld angegeben ist, müssen alle Felder von `backgroundImageFile` festgelegt werden.
`backgroundImageFile.id`	`string` Die ID einer Bilddatei in Google Drive für das Hintergrundbild.
`backgroundImageFile.xCoordinate`	`number` Die x-Koordinate der oberen linken Ecke des Zuschneidebereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert stellt den horizontalen Abstand von der linken Seite des gesamten Bilds zur linken Seite des Zuschneidebereichs geteilt durch die Breite des gesamten Bilds dar.
`backgroundImageFile.yCoordinate`	`number` Die Y-Koordinate der oberen linken Ecke des Zuschneidebereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert stellt den vertikalen Abstand von der oberen Seite des gesamten Bilds zur oberen Seite des Zuschneidebereichs dar, geteilt durch die Höhe des gesamten Bilds.
`backgroundImageFile.width`	`number` Breite des zugeschnittenen Bilds im geschlossenen Bereich zwischen 0 und 1. Dieser Wert stellt die Breite des zugeschnittenen Bilds geteilt durch die Breite des gesamten Bilds dar. Die Höhe wird berechnet, indem ein Seitenverhältnis von 80 bis 9 angewendet wird. Das resultierende 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 (RFC 3339 Datum/Uhrzeit).
`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` Sollen die Optionen zum Kopieren, Drucken oder Herunterladen von Dateien in dieser geteilten Ablage für Leser und Kommentatoren deaktiviert sein? Wenn diese Einschränkung auf `true` festgelegt ist, wird das ähnlich benannte Feld für jede Datei in dieser geteilten Ablage durch `true` überschrieben.
`restrictions.domainUsersOnly`	`boolean` Ob der Zugriff auf diese geteilte Ablage und die darin enthaltenen Elemente eingeschränkt ist, ist auf Nutzer der Domain beschränkt, zu der die geteilte Ablage gehört. Diese Einschränkung kann durch andere Freigaberichtlinien überschrieben werden, die außerhalb dieser geteilten Ablage gesteuert werden.
`restrictions.driveMembersOnly`	`boolean` Gibt an, ob der Zugriff auf Elemente in dieser geteilten Ablage auf die Mitglieder beschränkt ist.
`restrictions.adminManagedRestrictions`	`boolean` Gibt an, ob Administratorberechtigungen für diese geteilte Ablage erforderlich sind, um Einschränkungen zu ändern.
`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 „Datei-Organisator“ 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, für die der Nutzer eine `organizer` ist, wird endgültig gelöscht.
`get`	Ruft die Metadaten einer geteilten Ablage nach ID ab.
`hide`	Geteilte Ablagen werden in der Standardansicht ausgeblendet.
`list`	Listet die geteilten Ablagen des Nutzers auf.
`unhide`	Eine geteilte Ablage wird in der Standardansicht wiederhergestellt.
`update`	Das Datum einer geteilten Ablage wird aktualisiert.

REST Resource: drives

Ressource: Drive

Methoden

`create`

`delete`

`get`

`hide`

`list`

`unhide`

`update`