REST Resource: drives

Ressource : Drive

Représentation d'un Drive partagé.

Certaines méthodes de ressources (comme drives.update) nécessitent un driveId. Utilisez la méthode drives.list pour récupérer l'ID d'un Drive partagé.

Représentation 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
}
Champs
id

string

Uniquement en sortie. ID de ce Drive partagé, qui est également l'ID du dossier de premier niveau de ce Drive partagé.
name

string

Nom de ce Drive partagé.
colorRgb

string

Couleur de ce Drive partagé sous forme de chaîne hexadécimale RVB. Il ne peut être défini que sur une requête drive.drives.update qui ne définit pas themeId.
kind

string

Uniquement en sortie. Identifie le type de ressource. Valeur : chaîne fixe "drive#drive".
capabilities

object

Uniquement en sortie. Capacités dont dispose l'utilisateur actuel sur ce Drive partagé.
capabilities.canAddChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter des enfants aux dossiers de ce Drive partagé.
capabilities.canComment

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut commenter les fichiers de ce Drive partagé.
capabilities.canCopy

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut copier des fichiers dans ce Drive partagé.
capabilities.canDeleteDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer ce Drive partagé. La suppression du Drive partagé peut toujours échouer si des éléments non placés dans la corbeille se trouvent à l'intérieur.
capabilities.canDownload

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut télécharger des fichiers dans ce Drive partagé.
capabilities.canEdit

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier les fichiers de ce Drive partagé.
capabilities.canListChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lister les enfants des dossiers de ce Drive partagé.
capabilities.canManageMembers

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter ou supprimer des membres de ce Drive partagé, ou modifier leur rôle.
capabilities.canReadRevisions

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lire la ressource des révisions des fichiers de ce Drive partagé.
capabilities.canRename

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut renommer des fichiers ou des dossiers dans ce Drive partagé.
capabilities.canRenameDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut renommer ce Drive partagé.
capabilities.canChangeDriveBackground

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier l'arrière-plan de ce Drive partagé.
capabilities.canShare

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut partager des fichiers ou des dossiers dans ce Drive partagé.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier la restriction copyRequiresWriterPermission de ce Drive partagé.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier la restriction domainUsersOnly de ce Drive partagé.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier la restriction driveMembersOnly de ce Drive partagé.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier la restriction sharingFoldersRequiresOrganizerPermission de ce Drive partagé.
capabilities.canResetDriveRestrictions

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut rétablir les restrictions par défaut du Drive partagé.
capabilities.canDeleteChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer des enfants de dossiers dans ce Drive partagé.
capabilities.canTrashChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut placer des éléments enfants de dossiers de ce Drive partagé dans la corbeille.
capabilities.canChangeDownloadRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier les restrictions de téléchargement appliquées par l'organisateur à ce Drive partagé.
themeId

string

ID du thème à partir duquel l'image et la couleur d'arrière-plan seront définies. L'ensemble des driveThemes possibles peut être récupéré à partir d'une réponse drive.about.get. Lorsqu'aucun thème n'est spécifié dans une requête drive.drives.create, un thème aléatoire est choisi pour définir l'image et la couleur d'arrière-plan. Il s'agit d'un champ en écriture seule. Il ne peut être défini que dans les requêtes qui ne définissent pas colorRgb ni backgroundImageFile.
backgroundImageFile

object

Fichier image et paramètres de recadrage à partir desquels une image de fond est définie pour ce Drive partagé. Il s'agit d'un champ en écriture seule. Il ne peut être défini que sur les requêtes drive.drives.update qui ne définissent pas themeId. Lorsque ce champ est spécifié, tous les champs de backgroundImageFile doivent être définis.
backgroundImageFile.id

string

ID d'un fichier image dans Google Drive à utiliser pour l'image d'arrière-plan.
backgroundImageFile.xCoordinate

number

Coordonnée X de l'angle supérieur gauche de la zone de recadrage dans l'image de fond. Il s'agit d'une valeur comprise entre 0 et 1 (inclus). Cette valeur représente la distance horizontale entre le bord gauche de l'image entière et le bord gauche de la zone de recadrage, divisée par la largeur de l'image entière.
backgroundImageFile.yCoordinate

number

Coordonnée Y de l'angle supérieur gauche de la zone de recadrage dans l'image de fond. Il s'agit d'une valeur comprise entre 0 et 1 (inclus). Cette valeur représente la distance verticale entre le haut de l'image entière et le haut de la zone de recadrage, divisée par la hauteur de l'image entière.
backgroundImageFile.width

number

Largeur de l'image recadrée dans la plage fermée de 0 à 1. Cette valeur représente la largeur de l'image recadrée divisée par la largeur de l'image entière. La hauteur est calculée en appliquant un rapport largeur/hauteur de 80/9. L'image obtenue doit avoir une largeur d'au moins 1 280 pixels et une hauteur d'au moins 144 pixels.
createdTime

string

Uniquement en sortie. Heure à laquelle le Drive partagé a été créé (date et heure RFC 3339).
hidden

boolean

Indique si le Drive partagé est masqué dans la vue par défaut.
restrictions

object

Ensemble de restrictions qui s'appliquent à ce Drive partagé ou aux éléments qu'il contient. Notez que vous ne pouvez pas définir de restrictions lorsque vous créez un Drive partagé. Pour ajouter une restriction, commencez par créer un Drive partagé, puis utilisez drives.update pour ajouter des restrictions.
restrictions.copyRequiresWriterPermission

boolean

Indiquez si les options permettant de copier, d'imprimer ou de télécharger les fichiers de ce Drive partagé doivent être désactivées pour les lecteurs et les commentateurs. Lorsque cette restriction est définie sur true, elle remplace le champ du même nom par true pour tous les fichiers de ce Drive partagé.
restrictions.domainUsersOnly

boolean

Indique si l'accès à ce Drive partagé et aux éléments qu'il contient est limité aux utilisateurs du domaine auquel appartient ce Drive partagé. Cette restriction peut être remplacée par d'autres règles de partage contrôlées en dehors de ce Drive partagé.
restrictions.driveMembersOnly

boolean

Indique si l'accès aux éléments de ce Drive partagé est limité à ses membres.
restrictions.adminManagedRestrictions

boolean

Indique si des droits d'administrateur sur ce Drive partagé sont requis pour modifier les restrictions.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Si la valeur est "true", seuls les utilisateurs disposant du rôle d'organisateur peuvent partager des dossiers. Si la valeur est "false", les utilisateurs disposant du rôle d'organisateur ou d'organisateur de fichiers peuvent partager des dossiers.
restrictions.downloadRestriction

object (DownloadRestriction)

Restrictions de téléchargement appliquées par les administrateurs du Drive partagé.
orgUnitId

string

Uniquement en sortie. Unité organisationnelle de ce Drive partagé. Ce champ n'est renseigné dans les réponses drives.list que lorsque le paramètre useDomainAdminAccess est défini sur true.

Méthodes

create

 Crée un Drive partagé.

delete

 Supprime définitivement un Drive partagé dont l'utilisateur est organizer.

get

 Obtient les métadonnées d'un Drive partagé par ID.

hide

 Masque un Drive partagé dans la vue par défaut.

list

Liste les Drive partagés de l'utilisateur.

unhide

 Restaure un Drive partagé dans la vue par défaut.

update

 Met à jour les métadonnées d'un Drive partagé.