Mitbearbeiter mit Berechtigungen für Notizen hinzufügen und entfernen

Der Ersteller einer Notiz ist deren Eigentümer. Der Eigentümer kann weitere Mitbearbeitern, die Berechtigungen verwenden, die einzelnen Nutzern oder Gruppen gewährt wurden. Mitbearbeiter erhalten Bearbeitungszugriff auf die Notiz. Mitbearbeiter können auch ihre Berechtigungen, die über die API widerrufen wurden. Auf dieser Seite wird erläutert, wie Sie mit Berechtigungen arbeiten.

Berechtigungen zum Hinzufügen von Mitbearbeitern hinzufügen

Im folgenden Beispiel sehen Sie, wie Berechtigungen für einen Nutzer oder eine Gruppe zum Hinzufügen verwendet werden. Mitbearbeitern eine Notiz hinzufügen:

REST

Anruf notes.permissions.batchCreate() mit der übergeordneten Notiz, der die Berechtigung und permission zugewiesen wurde. Das Feld Mitglied (Nutzer, Gruppe) kann nur die Rolle WRITER zugewiesen werden.

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

Berechtigungen zum Entfernen von Mitbearbeitern widerrufen

Im folgenden Beispiel wird gezeigt, wie mithilfe von Berechtigungen alle Mitbearbeiter entfernt werden. aus einer Notiz:

REST

Anruf notes.permissions.batchDelete() mit der übergeordneten Notiz, der die Berechtigung und permission zugewiesen wurde.

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