افزودن و حذف همکاران یادداشت با مجوز

ایجادکننده‌ی یک یادداشت، مالک آن است. مالک می‌تواند با استفاده از مجوزهایی که به کاربران یا گروه‌های مختلف داده می‌شود، همکاران را اضافه کند. همکاران دسترسی ویرایش یادداشت را دارند. همچنین می‌توانید مجوزهای همکار را با استفاده از API لغو کنید. این صفحه نحوه‌ی اضافه کردن و حذف همکاران را با استفاده از مجوزها نشان می‌دهد.

اضافه کردن مجوزها برای افزودن همکاران

نمونه زیر نحوه استفاده از مجوزهای یک کاربر یا گروه برای افزودن همکاران به یک یادداشت را نشان می‌دهد:

استراحت

تابع notes.permissions.batchCreate() را با تخصیص مجوز و permission به یادداشت والد فراخوانی کنید. توجه داشته باشید که به عضو (کاربر، گروه) فقط می‌توان نقش WRITER اختصاص داد.

جاوا

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

لغو مجوزها برای حذف همکاران

نمونه زیر نحوه استفاده از مجوزها برای حذف همه همکاران از یک یادداشت را نشان می‌دهد:

استراحت

تابع notes.permissions.batchDelete() را با تخصیص مجوز و permission به note والد فراخوانی کنید.

جاوا

/**
 * Deletes all permissions of a given note excluding the owner. The owner
 * can't 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) {
    // The note owner can't be removed from the permissions. Trying to
    // remove the owner causes an exception.
    if (!permission.getRole().equals("OWNER")) {
      permissionsToDelete.add(permission.getName());
    }
  }

  keepService
      .notes()
      .permissions()
      .batchDelete(
          note.getName(),
          new BatchDeletePermissionsRequest().setNames(permissionsToDelete))
      .execute();
}