Cette page a été traduite par l'API Cloud Translation.

REST Resource: drives

Ressource: Drive
- Représentation JSON
Méthodes

Ressource: Drive

Représentation d'un Drive partagé.

Certaines méthodes de ressources (telles que 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 }, "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 }

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
  },
  "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
}

Champs
`id`	`string` Uniquement en sortie. ID de ce Drive partagé, qui correspond également à l'ID du dossier racine 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. Cette valeur est toujours `drive#drive`.
`backgroundImageLink`	`string` Uniquement en sortie. Lien temporaire vers l'image de fond de ce Drive partagé.
`capabilities`	`object` Uniquement en sortie. Permissions 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 ajouter des commentaires aux 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 tentative de suppression du Drive partagé peut toujours échouer si des éléments n'ont pas été placés dans la corbeille.
`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 des membres à ce Drive partagé, les supprimer ou modifier leur rôle.
`capabilities.canReadRevisions`	`boolean` Uniquement en sortie. Indique si l'utilisateur actuel peut lire la ressource de 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 de ce Drive partagé.
`capabilities.canTrashChildren`	`boolean` Uniquement en sortie. Indique si l'utilisateur actuel peut mettre à la corbeille les enfants des dossiers de 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`. Si ce paramètre n'est pas spécifié dans une requête `drive.drives.insert`, un thème aléatoire est choisi à partir duquel l'image et la couleur d'arrière-plan sont définies. Il s'agit d'un champ en écriture uniquement. Il ne peut être défini que sur les requêtes qui ne définissent pas `colorRgb` ou `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 uniquement. Il ne peut être défini que sur les requêtes `drive.drives.update` qui ne définissent pas `themeId`. Lorsqu'il 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 de fond.
`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. 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. 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, comprise entre 0 et 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 format de 80 x 9. L'image obtenue doit avoir une largeur d'au moins 1 280 pixels et une hauteur d'au moins 144 pixels.
`createdDate`	`string` Uniquement en sortie. Heure à laquelle le Drive partagé a été créé (date et heure au format 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.
`restrictions.copyRequiresWriterPermission`	`boolean` Indique si les options permettant de copier, d'imprimer ou de télécharger des fichiers dans 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 portant le même nom que `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 il appartient. 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é aux membres.
`restrictions.adminManagedRestrictions`	`boolean` Indique si des droits d'administrateur sur ce Drive partagé sont requis pour modifier les restrictions.
`restrictions.sharingFoldersRequiresOrganizerPermission`	`boolean` Si cette valeur est définie sur "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 de celui d'organisateur de fichiers peuvent partager des dossiers.
`orgUnitId`	`string` Uniquement en sortie. Unité organisationnelle de ce Drive partagé. Ce champ n'est renseigné que dans les réponses `drives.list` lorsque le paramètre `useDomainAdminAccess` est défini sur `true`.

Méthodes
`delete`	Supprime définitivement un Drive partagé pour lequel l'utilisateur est `organizer`.
`get`	Récupère les métadonnées d'un Drive partagé par ID.
`hide`	Masque un Drive partagé de la vue par défaut.
`insert`	Crée un Drive partagé.
`list`	Liste les Drive partagés de l'utilisateur.
`unhide`	Restaure la vue par défaut d'un Drive partagé.
`update`	Met à jour les métadonnées d'un Drive partagé.

REST Resource: drives

Ressource: Drive

Méthodes

`delete`

`get`

`hide`

`insert`

`list`

`unhide`

`update`