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
  },
  "createdTime": 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 come stringa esadecimale RGB. Può essere impostato solo su una richiesta drive.drives.update che non imposta themeId.

kind

string

Solo output. Identifica di che tipo di risorsa si tratta. Valore: la stringa fissa "drive#drive".

capabilities

object

Solo output. Le funzionalità dell'utente corrente su questo Drive condiviso.

capabilities.canAddChildren

boolean

Solo output. Indica se l'utente corrente può aggiungere bambini alle cartelle di questo Drive condiviso.

capabilities.canComment

boolean

Solo output. Se l'utente corrente può commentare i file di questo Drive condiviso.

capabilities.canCopy

boolean

Solo output. Se l'utente corrente può copiare file in questo Drive condiviso.

capabilities.canDeleteDrive

boolean

Solo output. 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. Se l'utente corrente può scaricare file di 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 gli elementi secondari delle cartelle 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 proprio ruolo.

capabilities.canReadRevisions

boolean

Solo output. 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. 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 dei Drive condivisi ai 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 gli elementi secondari dalle cartelle di questo Drive condiviso nel Cestino.

themeId

string

L'ID del tema da cui verranno impostati il colore e l'immagine di sfondo. L'insieme di possibili driveThemes può essere recuperato da una risposta drive.about.get. Se non viene 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 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 come immagine di sfondo.

backgroundImageFile.xCoordinate

number

La coordinata X dell'angolo in alto a sinistra dell'area di ritaglio nell'immagine di sfondo. Questo è un valore 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. Questo è un valore 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 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 a 9. L'immagine risultante deve essere larga almeno 1280 pixel in larghezza e 144 pixel in altezza.

createdTime

string

Solo output. L'ora in cui è stato creato il Drive condiviso (data-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. Tieni presente che non è possibile impostare limitazioni durante la creazione di un Drive condiviso. Per aggiungere una limitazione, crea prima un Drive condiviso, quindi usa drives.update per aggiungere limitazioni.

restrictions.copyRequiresWriterPermission

boolean

Indica se le opzioni per copiare, stampare o scaricare i file all'interno del Drive condiviso devono essere disattivate per i lettori e i commentatori. Se questa limitazione è impostata su true, sostituisce il campo con nome simile 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 ignorata 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 impostato su true, solo gli utenti con il ruolo organizzatore possono condividere le cartelle. Se il valore è falso, 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 solo per le risposte drives.list quando il parametro useDomainAdminAccess è impostato su true.

Metodi

create

Crea un Drive condiviso.

delete

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

get

Recupera i metadati di un Drive condiviso per ID.

hide

Nasconde un Drive condiviso dalla visualizzazione predefinita.

list

Elenca i Drive condivisi dell'utente.

unhide

Ripristina un Drive condiviso nella visualizzazione predefinita.

update

Aggiorna i metadati per un Drive condiviso.