REST Resource: drives

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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "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 geteilten Ablage als hexadezimaler RGB-String. Sie kann nur für eine drive.drives.update-Anfrage festgelegt werden, bei der themeId nicht festgelegt ist.
kind

string

Nur Ausgabe. Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "drive#drive".
capabilities

object

Nur Ausgabe. Funktionen, die der aktuelle Nutzer in dieser geteilten Ablage hat.
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 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. Der Versuch, die geteilte Ablage zu löschen, kann weiterhin fehlschlagen, wenn sich darin Elemente befinden, die nicht im Papierkorb sind.
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 Elemente von Ordnern in dieser geteilten Ablage auflisten kann.
capabilities.canManageMembers

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Mitglieder zu dieser geteilten Ablage 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 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 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 der geteilten 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.
capabilities.canChangeDownloadRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die vom Organisator angewendeten Downloadbeschränkungen dieser geteilten Ablage ändern 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.create-Anfrage kein Design angegeben ist, wird ein zufälliges Design ausgewählt, aus dem das Hintergrundbild und die Farbe festgelegt werden. Dies ist ein schreibgeschütztes Feld. Es kann nur für Anfragen festgelegt werden, für die colorRgb oder backgroundImageFile nicht festgelegt sind.
backgroundImageFile

object

Eine Bilddatei und Zuschneideparameter, mit denen ein Hintergrundbild für diese geteilte Ablage festgelegt wird. Dies ist ein Nur-Schreibfeld. Es kann nur für drive.drives.update-Anfragen festgelegt werden, bei denen themeId nicht festgelegt ist. Wenn sie angegeben werden, müssen alle Felder von backgroundImageFile festgelegt werden.
backgroundImageFile.id

string

Die ID einer Bilddatei in Google Drive, die als 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 gibt den horizontalen Abstand von der linken Seite des gesamten Bildes zur linken Seite des Zuschneidebereichs geteilt durch die Breite des gesamten Bildes an.
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 Oberseite des gesamten Bildes zur Oberseite des Zuschneidebereichs geteilt durch die Höhe des gesamten Bildes dar.
backgroundImageFile.width

number

Die Breite des zugeschnittenen Bildes 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 ein Seitenverhältnis von Breite zu Höhe von 80 zu 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. Beachten Sie, dass beim Erstellen einer geteilten Ablage keine Einschränkungen festgelegt werden können. Wenn Sie eine Einschränkung hinzufügen möchten, erstellen Sie zuerst eine geteilte Ablage und fügen Sie dann mit drives.update Einschränkungen hinzu.
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 gleichnamige Feld für alle Dateien in dieser geteilten Ablage auf true überschrieben.
restrictions.domainUsersOnly

boolean

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

boolean

Ob der Zugriff auf Elemente in dieser geteilten Ablage auf ihre 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

Wenn diese Option aktiviert ist, können nur Nutzer mit der Rolle „Organisator“ Ordner freigeben. Wenn „false“, können Nutzer mit der Rolle „Organisator“ oder „Datei-Organisator“ Ordner freigeben.
restrictions.downloadRestriction

object (DownloadRestriction)

Von Administratoren für geteilte Ablagen angewendete Downloadbeschränkungen.
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 gesetzt ist.

Methoden

create

 Erstellt eine geteilte Ablage.

delete

 Löscht eine geteilte Ablage, für die der Nutzer ein organizer ist, endgültig.

get

 Ruft die Metadaten einer geteilten Ablage anhand der ID ab.

hide

 Blendet eine geteilte Ablage in der Standardansicht aus.

list

Listet die geteilten Ablagen des Nutzers auf.

unhide

 Stellt eine geteilte Ablage in der Standardansicht wieder her.

update

 Aktualisiert die Metadaten für eine geteilte Ablage.