Enum DriveScope 

pub enum DriveScope {
    ReadOnly,
    Metadata,
}

The Drive OAuth2 scope granted at login.

Unlike Gmail’s readonly/modify split, Metadata is requested additively over ReadOnly, never as a replacement: drive.metadata alone grants no file-content access, so read commands (search, read, export/download) still need drive.readonly too. The authorization request for Metadata therefore asks for both scopes together — see [build_authorization_url].

Variants

ReadOnly

List/read/export/download files and metadata. Default; never requests any mutation.

Metadata

Everything ReadOnly grants, plus drive.metadata (files.update on name/parents — rename/move).

Implementations

impl DriveScope

pub fn as_str(self) -> &'static str

Returns the wire scope string Google expects for status-reporting / storage purposes. For Metadata this is just SCOPE_METADATA — the additive drive.readonly request shape lives in [build_authorization_url] alone, since Google’s granted- scope response and from_granted already round-trip correctly off the single SCOPE_METADATA token.

pub fn from_granted(granted: &str) -> Option<Self>

Parses Google’s space-separated granted-scope response, treating the presence of the metadata scope anywhere in it as Metadata and the readonly scope (with no metadata) as ReadOnly.

Returns None when neither Drive scope is present — e.g. the user left the Drive permission unticked on Google’s consent screen — so callers can reject the grant instead of silently defaulting to ReadOnly.

pub fn allows_write(self) -> bool

Whether this scope allows mutating calls (files.update on name/parents — rename/move).

Trait Implementations

impl Clone for DriveScope

fn clone(&self) -> DriveScope

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for DriveScope

impl Debug for DriveScope

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DriveScope

fn default() -> DriveScope

Returns the “default value” for a type.

impl Eq for DriveScope

impl PartialEq for DriveScope

fn eq(&self, other: &DriveScope) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DriveScope