REST Resource: drives

Risorsa: Drive

Rappresentazione di un Drive condiviso.

Alcuni metodi delle risorse (ad esempio 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
  },
  "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
}
Campi
id

string

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

string

Il nome di questo Drive condiviso.
colorRgb

string

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

string

Solo output. Questo valore è sempre 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 corrente può aggiungere cartelle secondarie alle cartelle di questo Drive condiviso.
capabilities.canComment

boolean

Solo output. Indica se l'utente corrente può aggiungere commenti ai file di 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 spostati nel cestino.
capabilities.canDownload

boolean

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

boolean

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

boolean

Solo output. Indica se l'utente corrente può elencare le cartelle secondarie in questo Drive condiviso.
capabilities.canManageMembers

boolean

Solo output. Indica se l'utente corrente può aggiungere membri a questo Drive condiviso, rimuoverli 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 corrente può rinominare file o cartelle in questo Drive condiviso.
capabilities.canRenameDrive

boolean

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

boolean

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

boolean

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

boolean

Solo output. Indica se l'utente corrente può modificare la restrizione copyRequiresWriterPermission di questo Drive condiviso.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Solo output. Indica se l'utente corrente può modificare la restrizione domainUsersOnly di questo Drive condiviso.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Solo output. Indica se l'utente corrente può modificare la restrizione driveMembersOnly di questo Drive condiviso.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Solo output. Indica se l'utente corrente può modificare la restrizione sharingFoldersRequiresOrganizerPermission di questo Drive condiviso.
capabilities.canResetDriveRestrictions

boolean

Solo output. Indica se l'utente corrente può reimpostare le restrizioni 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ò eliminare elementi secondari dalle cartelle in questo Drive condiviso.
themeId

string

L'ID del tema da cui verranno impostati l'immagine e il colore di sfondo. L'insieme di possibili driveThemes può essere recuperato da una risposta drive.about.get. Se non specificato in una richiesta drive.drives.insert, 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 nelle richieste drive.drives.update che non impostano themeId. Se specificato, tutti i campi di backgroundImageFile devono essere impostati.
backgroundImageFile.id

string

L'ID di un file immagine su 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 almeno 144 pixel.
createdDate

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.
restrictions.copyRequiresWriterPermission

boolean

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

boolean

Indica se l'accesso a questo Drive condiviso e agli elementi al suo interno è limitato agli utenti del dominio a cui appartiene. Questa limitazione può essere sostituita da altri criteri di condivisione controllati al di fuori di questo Drive condiviso.
restrictions.driveMembersOnly

boolean

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

boolean

Indica se per modificare le restrizioni sono necessari privilegi amministrativi su questo Drive condiviso.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Se il valore è true, solo gli utenti con il ruolo Organizzatore possono condividere le cartelle. Se è false, gli utenti con il ruolo Organizzatore o Organizzatore file possono condividere le cartelle.
orgUnitId

string

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

Metodi

delete

 Consente di eliminare definitivamente un Drive condiviso per il quale l'utente è un organizer.

get

 Recupera i metadati di un Drive condiviso tramite ID.

hide

 Nasconde un Drive condiviso dalla visualizzazione predefinita.

insert

 Crea un nuovo Drive condiviso.

list

Elenca i Drive condivisi dell'utente.

unhide

 Ripristina un Drive condiviso nella visualizzazione predefinita.

update

 Aggiorna i metadati di un Drive condiviso.