Le créateur de la note en est le propriétaire. Le propriétaire peut ajouter d'autres collaborateurs à l'aide d'autorisations accordées à des utilisateurs individuels ou à des groupes. Les collaborateurs peuvent modifier la note. Les collaborateurs peuvent également avoir autorisations révoquées à l'aide de l'API. Cette page explique comment ajouter et supprimer collaborateurs à l'aide d'autorisations.
Ajouter des autorisations pour ajouter des collaborateurs
L'exemple suivant montre comment utiliser des autorisations sur un utilisateur ou un groupe pour ajouter collaborateurs à une note:
REST
Appeler
notes.permissions.batchCreate()
avec l'autorisation associée à la note parente et permission
. Notez que
Seul le rôle WRITER
peut être attribué au membre (utilisateur, groupe).
Java
/**
* Grants write access to a user and to a Google group for the given note.
*
* @param note The note whose permissions will be updated.
* @param userEmail Email address of the user that will be added to the permissions of the note.
* @param groupEmail Email address of the Google group that will be added to the permissions of
* the note.
* @throws IOException
* @return The response of the create permissions request.
*/
private BatchCreatePermissionsResponse addPermissions(
Note note, String userEmail, String groupEmail) throws IOException {
String noteName = note.getName();
CreatePermissionRequest userPermission =
new CreatePermissionRequest()
.setParent(noteName)
.setPermission(new Permission().setEmail(userEmail).setRole("WRITER"));
CreatePermissionRequest groupPermission =
new CreatePermissionRequest()
.setParent(noteName)
.setPermission(new Permission().setEmail(groupEmail).setRole("WRITER"));
BatchCreatePermissionsRequest batchCreatePermissionsRequest =
new BatchCreatePermissionsRequest()
.setRequests(Arrays.asList(userPermission, groupPermission));
return keepService
.notes()
.permissions()
.batchCreate(noteName, batchCreatePermissionsRequest)
.execute();
}
Révoquer les autorisations permettant de supprimer des collaborateurs
L'exemple suivant montre comment utiliser des autorisations pour supprimer tous les collaborateurs à partir d'une note:
REST
Appeler
notes.permissions.batchDelete()
avec l'autorisation associée à la note parente et permission
.
Java
/**
* Deletes all permissions of a given note excluding the owner. Owner of the note cannot be
* removed from a note's permissions.
*
* @param note The note whose permissions will be deleted.
* @throws IOException
*/
private void deletePermissions(Note note) throws IOException {
List<Permission> notePermissions =
keepService.notes().get(note.getName()).execute().getPermissions();
// List of users, groups or families that will be deleted from the permissions of the note.
List<String> permissionsToDelete = new ArrayList<>();
for (Permission permission : notePermissions) {
// Note owner cannot be removed from the permissions of the note. Trying to remove the note
// owner from the permissions will cause an exception.
if (!permission.getRole().equals("OWNER")) {
permissionsToDelete.add(permission.getName());
}
}
keepService
.notes()
.permissions()
.batchDelete(
note.getName(), new BatchDeletePermissionsRequest().setNames(permissionsToDelete))
.execute();
}