Struct Method 

pub struct Method {
    pub id: String,
    pub http_method: String,
    pub path: String,
    pub flat_path: Option<String>,
    pub description: String,
    pub scopes: Vec<String>,
    pub required: Vec<String>,
    pub parameters: Vec<Parameter>,
    pub response_ref: Option<String>,
    pub request_ref: Option<String>,
}

Fields

id: String

http_method: String

path: String

flat_path: Option<String>

description: String

scopes: Vec<String>

required: Vec<String>

parameters: Vec<Parameter>

response_ref: Option<String>

Name of the response schema in the index’s schemas map, when the upstream method documents one (response.$ref).

request_ref: Option<String>

Name of the request-body schema in the index’s schemas map, when the upstream method documents one (request.$ref).

Implementations

impl Method

pub fn least_privilege_scope(&self) -> Option<&str>

Narrowest scope this method accepts, or None for the public methods that need no authorisation at all.

Discovery lists scopes in descending breadth (https://mail.google.com/ first), and the trailing entries are the narrow .../auth/gmail.readonly style. Preferring the last one keeps a describe call from requesting full mailbox access.

pub fn parameter(&self, name: &str) -> Option<&Parameter>

pub fn path_placeholders(&self) -> Vec<&str>

Placeholders in the path template, e.g. {userId} in gmail/v1/users/{userId}/messages.

RFC 6570 reserved-expansion markers are stripped: {+name} still refers to the parameter named name (Chat, People and Slides write their resource-name paths that way), so the returned names line up with Discovery’s parameter list.

pub fn reserved_path_placeholders(&self) -> Vec<&str>

The subset of Method::path_placeholders declared with RFC 6570 reserved expansion ({+name}): their values are full resource names (spaces/AAA/messages/BBB) that must keep their slashes in the path.

Trait Implementations

impl Clone for Method

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 Method

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Method

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Method

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

where __S: Serializer,

Serialize this value into the given Serde serializer.