Enum ProtectionResult 

pub enum ProtectionResult {
    WouldChange {
        summary: String,
    },
    RefusedNotASpreadsheet {
        mime_type: String,
    },
    RefusedShortcut,
    RefusedNoVisibleParents,
    RefusedSheetNotFound {
        title: String,
        available: Vec<String>,
    },
    RefusedInvalidRange {
        detail: String,
    },
    RefusedProtectionNotFound {
        detail: String,
    },
    RefusedAmbiguousProtection {
        candidates: Vec<i64>,
    },
    Blocked {
        decided_by: Option<DecidingRule>,
    },
    RefusedNoLease,
    RefusedLeaseExpired,
    RefusedLeaseWrongFile,
    RefusedLeaseStale,
    Changed {
        summary: String,
        protected_range_id: Option<i64>,
    },
    AppliedReplyUnreadable {
        summary: String,
        protected_range_id: Option<i64>,
        detail: String,
    },
    Failed {
        detail: String,
    },
}

What happened (or, under --dry-run, would happen).

Variants

WouldChange

--dry-run, and the gate would allow it.

Fields

summary: String

A human-readable summary of the effect.

RefusedNotASpreadsheet

The target is not a Google Sheet.

Fields

mime_type: String

The target’s actual MIME type.

RefusedShortcut

The target is a shortcut, which we do not follow.

RefusedNoVisibleParents

The target has no parents this account can see.

RefusedSheetNotFound

The named sheet does not exist in this workbook.

Fields

title: String

The title that was not found.

available: Vec<String>

The titles that do exist.

RefusedInvalidRange

The --sheet/--range pair was invalid.

Fields

detail: String

What was wrong and why.

RefusedProtectionNotFound

update-protection/unprotect-range found no protected range covering exactly the given target.

Fields

detail: String

What was searched for.

RefusedAmbiguousProtection

update-protection/unprotect-range’s target matched more than one protected range — refused rather than guessing which was meant.

Fields

candidates: Vec<i64>

The matching ids, so the user can disambiguate via list-protections.

Blocked

The folder write-permission gate refused it.

Fields

decided_by: Option<DecidingRule>

The rule that decided the refusal, if any.

RefusedNoLease

No --lease was presented, and the deciding rule requires one (ADR-0080 §9).

RefusedLeaseExpired

The presented lease has expired, or was never a token this ledger knows about.

RefusedLeaseWrongFile

The presented lease is bound to a different file id.

RefusedLeaseStale

The file has moved since the lease’s recorded version — the staleness check (ADR-0080 §6).

Changed

The mutation succeeded.

Fields

summary: String

Same summary as Self::WouldChange.

protected_range_id: Option<i64>

The protected range’s stable id — server-assigned for protect-range, otherwise the one resolved against.

AppliedReplyUnreadable

The API answered 2xx — the mutation was applied — but its reply could not be read (issue #2021). Distinct from Self::Failed: a retry here would stack a second protection over the same range. The server-assigned id of a new protected range was in that reply, so it is unknown.

Fields

summary: String

Same summary as Self::WouldChange.

protected_range_id: Option<i64>

The protected range id resolved before the call — Some for update-protection/unprotect-range, None for protect-range. Never the server-assigned id of a new protection (that was in the reply).

detail: String

Why the reply could not be read.

Failed

An API or validation error.

Fields

detail: String

A human-readable summary of what failed.

Trait Implementations

impl Clone for ProtectionResult

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProtectionResult

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

Formats the value using the given formatter.

impl Eq for ProtectionResult

impl PartialEq for ProtectionResult

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ProtectionResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProtectionResult