Menambahkan dan menghapus catatan kolaborator dengan izin

Pembuat catatan adalah pemilik catatan tersebut. Pemilik dapat menambahkan collaborator lain menggunakan izin yang diberikan kepada pengguna atau grup individual. Kolaborator mendapatkan akses edit ke catatan. Izin kolaborator juga dapat dicabut menggunakan API. Halaman ini menjelaskan cara menambahkan dan menghapus collaborator menggunakan izin.

Menambahkan izin untuk menambahkan kolaborator

Contoh berikut menunjukkan cara menggunakan izin pada pengguna atau grup untuk menambahkan collaborator ke catatan:

REST

Panggil notes.permissions.batchCreate() dengan catatan induk yang menetapkan izin dan permission. Perhatikan bahwa anggota (pengguna, grup) hanya dapat diberi peran WRITER.

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();
}

Mencabut izin untuk menghapus kolaborator

Contoh berikut menunjukkan cara menggunakan izin untuk menghapus semua kolaborator dari catatan:

REST

Panggil notes.permissions.batchDelete() dengan catatan induk yang menetapkan izin dan 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();
}