Struct onedrive_api::option::ObjectOption

pub struct ObjectOption<Field> { /* fields omitted */ }

Option for GET-like requests to one resource object.

Implementations

impl<Field: ResourceField> ObjectOption<Field>

pub fn new() -> Self

Create an empty (default) option.

pub fn if_match(self, tag: &Tag) -> Self

Only response if the object matches the tag.

Will cause HTTP 412 Precondition Failed otherwise.

It is usually used for PUT-like requests to assert preconditions, but most of GET-like requests also support it.

It will add If-Match to the request header.

pub fn if_none_match(self, tag: &Tag) -> Self

Only response if the object does not match the tag.

Will cause the relative API returns None otherwise.

It is usually used for GET-like requests to reduce data transmission if cached data can be reused.

This will add If-None-Match to the request header.

pub fn select(self, fields: &[Field]) -> Self

Select only some fields of the resource object.

See documentation of module onedrive_api::resource for more details.

Note

If called more than once, all fields mentioned will be selected.

See also

Microsoft Docs

pub fn expand(self, field: Field, select_children: Option<&[&str]>) -> Self

Expand a field of the resource object.

See documentation of module onedrive_api::resource for more details.

Note

If called more than once, all fields mentioned will be expanded. select_children should be raw camelCase field names mentioned in Microsoft Docs below.

See also

Microsoft Docs

Trait Implementations

impl<Field: Debug> Debug for ObjectOption<Field>

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

Formats the value using the given formatter.

impl<Field: ResourceField> Default for ObjectOption<Field>

fn default() -> Self

Returns the “default value” for a type.