REST Resource: drives

Ressource: Drive

Darstellung einer geteilten Ablage.

Einige Ressourcenmethoden (z. B. drives.update) erfordern eine driveId. Verwenden Sie die Methode drives.list, um die ID einer geteilten 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
}
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 der geteilten Ablage.

colorRgb

string

Die Farbe dieser geteilten Ablage als hexadezimaler RGB-String. Es kann nur für eine drive.drives.update-Anfrage festgelegt werden, die themeId nicht festlegt.

kind

string

Nur Ausgabe Dies ist immer drive#drive

capabilities

object

Nur Ausgabe Berechtigungen des aktuellen Nutzers für diese geteilte Ablage.

capabilities.canAddChildren

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer untergeordnete Elemente zu Ordnern in dieser geteilten Ablage hinzufügen darf.

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 weiterhin fehlschlagen, wenn sich darin 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 Gibt an, ob der aktuelle Nutzer die untergeordneten Elemente von Ordnern 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 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 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 darf.

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 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 kann.

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, in dem das Hintergrundbild und die Farbe festgelegt werden. Der Satz möglicher driveThemes kann aus einer drive.about.get-Antwort abgerufen werden. Wenn dies nicht in einer drive.drives.insert-Anfrage angegeben ist, wird ein zufälliges Design ausgewählt, aus dem Hintergrundbild und -farbe festgelegt werden. Dies ist ein schreibgeschütztes Feld. Es kann nur für Anfragen festgelegt werden, die colorRgb oder backgroundImageFile nicht festlegen.

backgroundImageFile

object

Eine Bilddatei und Zuschneideparameter, anhand derer ein Hintergrundbild für diese geteilte Ablage erstellt wird. Dieses Feld ist schreibgeschützt. Es kann nur für drive.drives.update-Anfragen ohne themeId festgelegt werden. 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 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 oberen linken Ecke des Zuschneidebereichs im Hintergrundbild. Dies ist ein Wert im geschlossenen Bereich von 0 bis 1. Dieser Wert entspricht dem vertikalen Abstand zwischen der Oberseite des gesamten Bildes und der Oberseite des Zuschneidebereichs, geteilt durch die Höhe des gesamten Bildes.

backgroundImageFile.width

number

Die Breite des zugeschnittenen Bildes 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 fertige Bild muss mindestens 1.280 Pixel breit und 144 Pixel hoch sein.

createdDate

string

Nur Ausgabe Der Zeitpunkt, zu dem die geteilte Ablage erstellt wurde (Datum/Uhrzeit gemäß RFC 3339).

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

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

Legt fest, ob der Zugriff auf diese geteilte Ablage und die Elemente in dieser geteilten Ablage auf Nutzer der Domain beschränkt ist, zu der die geteilte Ablage gehört. Diese Einschränkung kann durch andere Freigaberichtlinien überschrieben werden, die außerhalb dieser geteilten Ablage verwaltet werden.

restrictions.driveMembersOnly

boolean

Legt fest, ob der Zugriff auf Elemente in dieser geteilten Ablage auf die Mitglieder der geteilten Ablage 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. Wenn die Richtlinie auf „false“ gesetzt ist, können Nutzer mit der Rolle „Organisator“ oder „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

delete

Geteilte Ablagen, deren organizer-Nutzer der Nutzer ist, werden endgültig gelöscht.

get

Ruft die Metadaten einer geteilten Ablage nach ID ab.

hide

Geteilte Ablagen aus der Standardansicht ausblenden

insert

Eine neue geteilte Ablage wird erstellt.

list

Listet die geteilten Ablagen des Nutzers auf.

unhide

Stellt die Standardansicht einer geteilten Ablage wieder her.

update

Aktualisiert die Metadaten einer geteilten Ablage.