REST Resource: drives

Risorsa: Drive

Rappresentazione di un Drive condiviso.

Alcuni metodi di risorse (come drives.update) richiedono un driveId. Utilizza il metodo drives.list per recuperare l'ID di un Drive condiviso.

Rappresentazione JSON 
{
  "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
}
Campi
id

string

Solo output. L'ID di questo Drive condiviso, che è anche l'ID della cartella di primo livello del Drive condiviso.
name

string

Il nome di questo Drive condiviso.
colorRgb

string

Il colore di questo Drive condiviso come stringa esadecimale RGB. Può essere impostato solo su una richiesta drive.drives.update che non imposta themeId.
kind

string

Solo output. Identifica il tipo di risorsa. Valore: la stringa fissa "drive#drive".
capabilities

object

Solo output. Funzionalità di cui dispone l'utente corrente su questo Drive condiviso.
capabilities.canAddChildren

boolean

Solo output. Indica se l'utente attuale può aggiungere elementi secondari alle cartelle di questo Drive condiviso.
capabilities.canComment

boolean

Solo output. Indica se l'utente attuale può commentare i file in questo Drive condiviso.
capabilities.canCopy

boolean

Solo output. Indica se l'utente corrente può copiare i file in questo Drive condiviso.
capabilities.canDeleteDrive

boolean

Solo output. Indica se l'utente corrente può eliminare questo Drive condiviso. Il tentativo di eliminare il Drive condiviso potrebbe comunque non riuscire se al suo interno sono presenti elementi non eliminati.
capabilities.canDownload

boolean

Solo output. Se l'utente corrente può scaricare i file in questo Drive condiviso.
capabilities.canEdit

boolean

Solo output. Se l'utente corrente può modificare i file in questo Drive condiviso
capabilities.canListChildren

boolean

Solo output. Indica se l'utente corrente può elencare i figli delle cartelle in questo Drive condiviso.
capabilities.canManageMembers

boolean

Solo output. Se l'utente corrente può aggiungere o rimuovere membri da questo Drive condiviso o modificarne il ruolo.
capabilities.canReadRevisions

boolean

Solo output. Indica se l'utente corrente può leggere la risorsa delle revisioni dei file in questo Drive condiviso.
capabilities.canRename

boolean

Solo output. Indica se l'utente attuale può rinominare file o cartelle in questo Drive condiviso.
capabilities.canRenameDrive

boolean

Solo output. Se l'utente corrente può rinominare questo Drive condiviso.
capabilities.canChangeDriveBackground

boolean

Solo output. Se l'utente corrente può modificare lo sfondo di questo Drive condiviso.
capabilities.canShare

boolean

Solo output. Indica se l'utente attuale può condividere file o cartelle in questo Drive condiviso.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Solo output. Se l'utente corrente può modificare la limitazione copyRequiresWriterPermission di questo Drive condiviso.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Solo output. Se l'utente corrente può modificare la limitazione domainUsersOnly di questo Drive condiviso.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Solo output. Se l'utente corrente può modificare la limitazione driveMembersOnly di questo Drive condiviso.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Solo output. Se l'utente corrente può modificare la limitazione sharingFoldersRequiresOrganizerPermission di questo Drive condiviso.
capabilities.canResetDriveRestrictions

boolean

Solo output. Indica se l'utente attuale può reimpostare le limitazioni del Drive condiviso sui valori predefiniti.
capabilities.canDeleteChildren

boolean

Solo output. Indica se l'utente corrente può eliminare elementi secondari dalle cartelle di questo Drive condiviso.
capabilities.canTrashChildren

boolean

Solo output. Indica se l'utente corrente può spostare nel cestino gli elementi secondari delle cartelle in questo Drive condiviso.
capabilities.canChangeDownloadRestriction

boolean

Solo output. Indica se l'utente attuale può modificare le limitazioni di download applicate dall'organizzatore di questo Drive condiviso.
themeId

string

L'ID del tema da cui verranno impostati l'immagine e il colore di sfondo. Il set di possibili driveThemes può essere recuperato da una risposta drive.about.get. Se non specificato in una richiesta drive.drives.create, viene scelto un tema casuale da cui vengono impostati l'immagine e il colore di sfondo. Questo è un campo di sola scrittura; può essere impostato solo per le richieste che non impostano colorRgb o backgroundImageFile.
backgroundImageFile

object

Un file immagine e i parametri di ritaglio da cui viene impostata un'immagine di sfondo per questo Drive condiviso. Questo è un campo di sola scrittura; può essere impostato solo sulle richieste drive.drives.update che non impostano themeId. Se specificati, tutti i campi di backgroundImageFile devono essere impostati.
backgroundImageFile.id

string

L'ID di un file immagine in Google Drive da utilizzare per l'immagine di sfondo.
backgroundImageFile.xCoordinate

number

La coordinata X dell'angolo in alto a sinistra dell'area di ritaglio nell'immagine di sfondo. Si tratta di un valore compreso nell'intervallo chiuso da 0 a 1. Questo valore rappresenta la distanza orizzontale dal lato sinistro dell'intera immagine al lato sinistro dell'area di ritaglio divisa per la larghezza dell'intera immagine.
backgroundImageFile.yCoordinate

number

La coordinata Y dell'angolo in alto a sinistra dell'area di ritaglio nell'immagine di sfondo. Si tratta di un valore compreso nell'intervallo chiuso da 0 a 1. Questo valore rappresenta la distanza verticale dal lato superiore dell'intera immagine al lato superiore dell'area di ritaglio divisa per l'altezza dell'intera immagine.
backgroundImageFile.width

number

La larghezza dell'immagine ritagliata nell'intervallo chiuso da 0 a 1. Questo valore rappresenta la larghezza dell'immagine ritagliata divisa per la larghezza dell'intera immagine. L'altezza viene calcolata applicando un rapporto larghezza/altezza di 80:9. L'immagine risultante deve avere una larghezza di almeno 1280 pixel e un'altezza di 144 pixel.
createdTime

string

Solo output. L'ora in cui è stato creato il Drive condiviso (data e ora RFC 3339).
hidden

boolean

Indica se il Drive condiviso è nascosto nella visualizzazione predefinita.
restrictions

object

Un insieme di limitazioni che si applicano a questo Drive condiviso o agli elementi al suo interno. Tieni presente che non è possibile impostare limitazioni durante la creazione di un Drive condiviso. Per aggiungere una limitazione, crea prima un Drive condiviso e poi utilizza drives.update per aggiungere le limitazioni.
restrictions.copyRequiresWriterPermission

boolean

Se le opzioni per copiare, stampare o scaricare i file all'interno di questo Drive condiviso devono essere disattivate per lettori e commentatori. Quando questa limitazione è impostata su true, il campo con nome simile viene sostituito da true per qualsiasi file all'interno di questo Drive condiviso.
restrictions.domainUsersOnly

boolean

Se l'accesso a questo Drive condiviso e agli elementi al suo interno è limitato agli utenti del dominio a cui appartiene questo Drive condiviso. Questa limitazione può essere ignorata da altre norme di condivisione controllate al di fuori di questo Drive condiviso.
restrictions.driveMembersOnly

boolean

Se l'accesso agli elementi all'interno di questo Drive condiviso è limitato ai suoi membri.
restrictions.adminManagedRestrictions

boolean

Se per modificare le limitazioni sono necessari privilegi amministrativi su questo Drive condiviso.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Se è vero, solo gli utenti con il ruolo di organizzatore possono condividere le cartelle. Se il valore è false, gli utenti con il ruolo di organizzatore o di organizzatore dei file possono condividere le cartelle.
restrictions.downloadRestriction

object (DownloadRestriction)

Limitazioni al download applicate dai gestori del Drive condiviso.
orgUnitId

string

Solo output. L'unità organizzativa di questo Drive condiviso. Questo campo viene compilato solo nelle risposte drives.list quando il parametro useDomainAdminAccess è impostato su true.

Metodi

create

 Crea un Drive condiviso.

delete

 Elimina definitivamente un Drive condiviso per il quale l'utente è un organizer.

get

 Recupera i metadati di un Drive condiviso in base all'ID.

hide

 Nasconde un Drive condiviso dalla visualizzazione predefinita.

list

Elenca i Drive condivisi dell'utente.

unhide

 Ripristina la visualizzazione predefinita di un Drive condiviso.

update

 Aggiorna i metadati di un Drive condiviso.