NAME

Google::RestApi::DriveApi3::Permission - Permission object for Google Drive files.

SYNOPSIS

# Get a permission object
my $perm = $file->permission(id => 'permission_id');

# Get permission details
my $details = $perm->get();

# Create a new permission
my $new_perm = $file->permission()->create(
  role  => 'reader',
  type  => 'user',
  email_address => 'user@example.com',
);

# Make file publicly readable
$file->permission()->create(
  role => 'reader',
  type => 'anyone',
);

# Update permission
$perm->update(role => 'writer');

# Delete permission
$perm->delete();

DESCRIPTION

Represents a permission on a Google Drive file. Supports creating, reading, updating, and deleting permissions.

METHODS

create(role => $role, type => $type, ...)

Creates a new permission. Required parameters: - role: 'owner', 'organizer', 'fileOrganizer', 'writer', 'commenter', 'reader' - type: 'user', 'group', 'domain', 'anyone'

Optional parameters: - email_address: For 'user' or 'group' type - domain: For 'domain' type - send_notification: Send email notification (default: false) - email_message: Custom message for notification - transfer_ownership: Transfer ownership (default: false)

get(fields => $fields)

Gets permission details. Requires permission ID.

update(role => $role)

Updates the permission role. Requires permission ID.

delete()

Deletes the permission. Requires permission ID.

permission_id()

Returns the permission ID.

file()

Returns the parent File object.

AUTHORS

• Robin Murray mvsjes@cpan.org

COPYRIGHT

Copyright (c) 2019-2026 Robin Murray. All rights reserved.

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.