REST Resource: drives

Risorsa: Drive

Rappresentazione di un Drive condiviso.

Alcuni metodi delle 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
  },
  "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 al suo interno.
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. Questo valore è sempre drive#drive
capabilities

object

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

boolean

Solo output. Indica se l'utente corrente può aggiungere bambini e ragazzi 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 file in questo Drive condiviso.
capabilities.canDeleteDrive

boolean

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

boolean

Solo output. Indica se l'utente corrente può scaricare 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 le cartelle secondarie di questo Drive condiviso.
capabilities.canManageMembers

boolean

Solo output. Indica se l'utente corrente può aggiungere membri a questo Drive condiviso, rimuoverli o modificare il loro ruolo.
capabilities.canReadRevisions

boolean

Solo output. Indica se l'utente corrente può leggere la risorsa delle revisioni dei file di 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 limitazione copyRequiresWriterPermission di questo Drive condiviso.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Solo output. Indica se l'utente corrente può spostare i bambini nel cestino dalle cartelle di questo Drive condiviso.
themeId

string

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

object

Un file immagine e parametri di ritaglio da cui è impostata un'immagine di sfondo per questo Drive condiviso. Questo è un campo di sola scrittura e può essere impostato solo su richieste drive.drives.update che non impostano themeId. Se specificato, è necessario impostare tutti i campi di backgroundImageFile.
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. È un valore compreso nell'intervallo chiuso compreso tra 0 e 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. È un valore compreso nell'intervallo chiuso compreso tra 0 e 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 in un intervallo chiuso compreso tra 0 e 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 essere di almeno 1280 pixel di larghezza e 144 pixel di altezza.
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 dalla 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 file all'interno di questo Drive condiviso devono essere disattivate per lettori e commentatori. Se questa limitazione è impostata su true, il campo con nome simile verrà sostituito su true per tutti i 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 il Drive condiviso. Questa limitazione potrebbe essere sostituita da altri criteri di condivisione controllati all'esterno 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 sono necessari privilegi amministrativi su questo Drive condiviso per modificare le limitazioni.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

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

string

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

Metodi

delete

 Elimina definitivamente un Drive condiviso di cui l'utente è organizer.

get

 Recupera i metadati di un Drive condiviso per ID.

hide

 Nasconde un Drive condiviso dalla visualizzazione predefinita.

insert

 Crea un nuovo Drive condiviso.

list

Elenca i Drive condivisi dell'utente.

unhide

 Ripristina la visualizzazione predefinita di un Drive condiviso.

update

 Aggiorna i metadati per un Drive condiviso.