Struct gsuite_api::users::Users

source · [−]

pub struct Users {
    pub client: Client,
}

Fields

client: Client

Implementations

source

impl Users

source

pub async fn list(
 &self,
 customer: &str,
 domain: &str,
 event: Event,
 max_results: i64,
 order_by: DirectoryUsersListOrderBy,
 page_token: &str,
 projection: DirectoryUsersListProjection,
 query: &str,
 show_deleted: &str,
 sort_order: SortOrder,
 view_type: ViewType
) -> Result<Vec<User>>

This function performs a GET to the /admin/directory/v1/users endpoint.

Retrieves a paginated list of either deleted users or all users in a domain.

Parameters:

custom_field_mask: &str – A comma-separated list of schema names. All fields from these schemas are fetched. This should only be set when projection=custom.
customer: &str – The unique ID for the customer’s Google Workspace account. In case of a multi-domain account, to fetch all groups for a customer, fill this field instead of domain. You can also use the my_customer alias to represent your account’s customerId. The customerId is also returned as part of the Users resource. Either the customer or the domain parameter must be provided.
domain: &str – The domain name. Use this field to get fields from only one domain. To return all domains for a customer account, use the customer query parameter instead. Either the customer or the domain parameter must be provided.
event: crate::types::Event – Event on which subscription is intended (if subscribing).
max_results: i64 – Maximum number of results to return.
order_by: crate::types::DirectoryUsersListOrderBy – Property to use for sorting results.
page_token: &str – Token to specify next page in the list.
projection: crate::types::DirectoryUsersListProjection – What subset of fields to fetch for this user.
query: &str – Query string for searching user fields. For more information on constructing user queries, see Search for Users.
show_deleted: &str – If set to true, retrieves the list of deleted users. (Default: false).
sort_order: crate::types::SortOrder – Whether to return results in ascending or descending order. Must be used with the orderBy parameter.
view_type: crate::types::ViewType – Whether to fetch the administrator-only or domain-wide public view of the user. For more information, see Retrieve a user as a non-administrator.

source

pub async fn list_all(
 &self,
 customer: &str,
 domain: &str,
 event: Event,
 order_by: DirectoryUsersListOrderBy,
 projection: DirectoryUsersListProjection,
 query: &str,
 show_deleted: &str,
 sort_order: SortOrder,
 view_type: ViewType
) -> Result<Vec<User>>

This function performs a GET to the /admin/directory/v1/users endpoint.

As opposed to list, this function returns all the pages of the request at once.

Retrieves a paginated list of either deleted users or all users in a domain.

source

pub async fn insert(&self, body: &User) -> Result<User>

This function performs a POST to the /admin/directory/v1/users endpoint.

Creates a user.

source

pub async fn watch(
 &self,
 customer: &str,
 domain: &str,
 event: Event,
 max_results: i64,
 order_by: DirectoryUsersListOrderBy,
 page_token: &str,
 projection: DirectoryUsersListProjection,
 query: &str,
 show_deleted: &str,
 sort_order: SortOrder,
 view_type: ViewType,
 body: &Channel
) -> Result<Channel>

This function performs a POST to the /admin/directory/v1/users/watch endpoint.

Watches for changes in users list.

Parameters:

custom_field_mask: &str – Comma-separated list of schema names. All fields from these schemas are fetched. This should only be set when projection=custom.
customer: &str – Immutable ID of the Google Workspace account. In case of multi-domain, to fetch all users for a customer, fill this field instead of domain.
domain: &str – Name of the domain. Fill this field to get users from only this domain. To return all users in a multi-domain fill customer field instead.“.
event: crate::types::Event – Event on which subscription is intended (if subscribing).
max_results: i64 – Maximum number of results to return.
order_by: crate::types::DirectoryUsersListOrderBy – Property to use for sorting results.
page_token: &str – Token to specify next page in the list.
projection: crate::types::DirectoryUsersListProjection – What subset of fields to fetch for this user.
query: &str – Query string search. Should be of the form “”. Complete documentation is at https: //developers.google.com/admin-sdk/directory/v1/guides/search-users.
show_deleted: &str – If set to true, retrieves the list of deleted users. (Default: false).
sort_order: crate::types::SortOrder – Whether to return results in ascending or descending order. Must be used with the orderBy parameter.
view_type: crate::types::ViewType – Whether to fetch the administrator-only or domain-wide public view of the user. For more information, see Retrieve a user as a non-administrator.

source

pub async fn get(
 &self,
 user_key: &str,
 projection: DirectoryUsersListProjection,
 view_type: ViewType
) -> Result<User>

This function performs a GET to the /admin/directory/v1/users/{userKey} endpoint.

Retrieves a user.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.
custom_field_mask: &str – A comma-separated list of schema names. All fields from these schemas are fetched. This should only be set when projection=custom.
projection: crate::types::DirectoryUsersListProjection – What subset of fields to fetch for this user.
view_type: crate::types::ViewType – Whether to fetch the administrator-only or domain-wide public view of the user. For more information, see Retrieve a user as a non-administrator.

source

pub async fn update(&self, user_key: &str, body: &User) -> Result<User>

This function performs a PUT to the /admin/directory/v1/users/{userKey} endpoint.

Updates a user. This method supports patch semantics, meaning you only need to include the fields you wish to update. Fields that are not present in the request will be preserved, and fields set to null will be cleared.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn delete(&self, user_key: &str) -> Result<()>

This function performs a DELETE to the /admin/directory/v1/users/{userKey} endpoint.

Deletes a user.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn patch(&self, user_key: &str, body: &User) -> Result<User>

This function performs a PATCH to the /admin/directory/v1/users/{userKey} endpoint.

Updates a user using patch semantics. The update method should be used instead, since it also supports patch semantics and has better performance. This method is unable to clear fields that contain repeated objects (addresses, phones, etc). Use the update method instead.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn aliases_list(
 &self,
 user_key: &str,
 event: DirectoryUsersAliasesListEvent
) -> Result<Aliases>

This function performs a GET to the /admin/directory/v1/users/{userKey}/aliases endpoint.

Lists all aliases for a user.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.
event: crate::types::DirectoryUsersAliasesListEvent – Events to watch for.

source

pub async fn aliases_insert(
 &self,
 user_key: &str,
 body: &Alias
) -> Result<Alias>

This function performs a POST to the /admin/directory/v1/users/{userKey}/aliases endpoint.

Adds an alias.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn aliases_watch(
 &self,
 user_key: &str,
 event: DirectoryUsersAliasesListEvent,
 body: &Channel
) -> Result<Channel>

This function performs a POST to the /admin/directory/v1/users/{userKey}/aliases/watch endpoint.

Watches for changes in users list.

Parameters:

user_key: &str – Email or immutable ID of the user.
event: crate::types::DirectoryUsersAliasesListEvent – Events to watch for.

source

pub async fn aliases_delete(&self, user_key: &str, alias: &str) -> Result<()>

This function performs a DELETE to the /admin/directory/v1/users/{userKey}/aliases/{alias} endpoint.

Removes an alias.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.
alias: &str – The alias to be removed.

source

pub async fn make_admin(
 &self,
 user_key: &str,
 body: &UserMakeAdmin
) -> Result<()>

This function performs a POST to the /admin/directory/v1/users/{userKey}/makeAdmin endpoint.

Makes a user a super administrator.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn photos_get(&self, user_key: &str) -> Result<UserPhoto>

This function performs a GET to the /admin/directory/v1/users/{userKey}/photos/thumbnail endpoint.

Retrieves the user’s photo.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn photos_update(
 &self,
 user_key: &str,
 body: &UserPhoto
) -> Result<UserPhoto>

This function performs a PUT to the /admin/directory/v1/users/{userKey}/photos/thumbnail endpoint.

Adds a photo for the user.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn photos_delete(&self, user_key: &str) -> Result<()>

This function performs a DELETE to the /admin/directory/v1/users/{userKey}/photos/thumbnail endpoint.

Removes the user’s photo.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn photos_patch(
 &self,
 user_key: &str,
 body: &UserPhoto
) -> Result<UserPhoto>

This function performs a PATCH to the /admin/directory/v1/users/{userKey}/photos/thumbnail endpoint.

Adds a photo for the user. This method supports patch semantics.

Parameters:

user_key: &str – Identifies the user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn sign_out(&self, user_key: &str) -> Result<()>

This function performs a POST to the /admin/directory/v1/users/{userKey}/signOut endpoint.

Signs a user out of all web and device sessions and reset their sign-in cookies. User will have to sign in by authenticating again.

Parameters:

user_key: &str – Identifies the target user in the API request. The value can be the user’s primary email address, alias email address, or unique user ID.

source

pub async fn undelete(&self, user_key: &str, body: &UserUndelete) -> Result<()>

This function performs a POST to the /admin/directory/v1/users/{userKey}/undelete endpoint.

Undeletes a deleted user.

Parameters:

user_key: &str – The immutable id of the user.

Auto Trait Implementations

impl !RefUnwindSafe for Users

impl Send for Users

impl Sync for Users

impl Unpin for Users

impl !UnwindSafe for Users

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn vzip(self) -> V

source

impl<T> WithSubscriber for T

source

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

source

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Struct gsuite_api::users::Users

Fields

Implementations

impl Users

pub async fn list( &self, customer: &str, domain: &str, event: Event, max_results: i64, order_by: DirectoryUsersListOrderBy, page_token: &str, projection: DirectoryUsersListProjection, query: &str, show_deleted: &str, sort_order: SortOrder, view_type: ViewType) -> Result<Vec<User>>

pub async fn list_all( &self, customer: &str, domain: &str, event: Event, order_by: DirectoryUsersListOrderBy, projection: DirectoryUsersListProjection, query: &str, show_deleted: &str, sort_order: SortOrder, view_type: ViewType) -> Result<Vec<User>>

pub async fn insert(&self, body: &User) -> Result<User>

pub async fn watch( &self, customer: &str, domain: &str, event: Event, max_results: i64, order_by: DirectoryUsersListOrderBy, page_token: &str, projection: DirectoryUsersListProjection, query: &str, show_deleted: &str, sort_order: SortOrder, view_type: ViewType, body: &Channel) -> Result<Channel>

pub async fn get( &self, user_key: &str, projection: DirectoryUsersListProjection, view_type: ViewType) -> Result<User>

pub async fn update(&self, user_key: &str, body: &User) -> Result<User>

pub async fn delete(&self, user_key: &str) -> Result<()>

pub async fn patch(&self, user_key: &str, body: &User) -> Result<User>

pub async fn aliases_list( &self, user_key: &str, event: DirectoryUsersAliasesListEvent) -> Result<Aliases>

pub async fn aliases_insert( &self, user_key: &str, body: &Alias) -> Result<Alias>

pub async fn aliases_watch( &self, user_key: &str, event: DirectoryUsersAliasesListEvent, body: &Channel) -> Result<Channel>

pub async fn aliases_delete(&self, user_key: &str, alias: &str) -> Result<()>

pub async fn make_admin( &self, user_key: &str, body: &UserMakeAdmin) -> Result<()>

pub async fn photos_get(&self, user_key: &str) -> Result<UserPhoto>

pub async fn photos_update( &self, user_key: &str, body: &UserPhoto) -> Result<UserPhoto>

pub async fn photos_delete(&self, user_key: &str) -> Result<()>

pub async fn photos_patch( &self, user_key: &str, body: &UserPhoto) -> Result<UserPhoto>

pub async fn sign_out(&self, user_key: &str) -> Result<()>

pub async fn undelete(&self, user_key: &str, body: &UserUndelete) -> Result<()>

Auto Trait Implementations

impl !RefUnwindSafe for Users

impl Send for Users

impl Sync for Users

impl Unpin for Users

impl !UnwindSafe for Users

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self>

fn with_current_context(self) -> WithContext<Self>

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self>

pub async fn list(
&self,
customer: &str,
domain: &str,
event: Event,
max_results: i64,
order_by: DirectoryUsersListOrderBy,
page_token: &str,
projection: DirectoryUsersListProjection,
query: &str,
show_deleted: &str,
sort_order: SortOrder,
view_type: ViewType
) -> Result<Vec<User>>

pub async fn list_all(
&self,
customer: &str,
domain: &str,
event: Event,
order_by: DirectoryUsersListOrderBy,
projection: DirectoryUsersListProjection,
query: &str,
show_deleted: &str,
sort_order: SortOrder,
view_type: ViewType
) -> Result<Vec<User>>

pub async fn watch(
&self,
customer: &str,
domain: &str,
event: Event,
max_results: i64,
order_by: DirectoryUsersListOrderBy,
page_token: &str,
projection: DirectoryUsersListProjection,
query: &str,
show_deleted: &str,
sort_order: SortOrder,
view_type: ViewType,
body: &Channel
) -> Result<Channel>

pub async fn get(
&self,
user_key: &str,
projection: DirectoryUsersListProjection,
view_type: ViewType
) -> Result<User>

pub async fn aliases_list(
&self,
user_key: &str,
event: DirectoryUsersAliasesListEvent
) -> Result<Aliases>

pub async fn aliases_insert(
&self,
user_key: &str,
body: &Alias
) -> Result<Alias>

pub async fn aliases_watch(
&self,
user_key: &str,
event: DirectoryUsersAliasesListEvent,
body: &Channel
) -> Result<Channel>

pub async fn make_admin(
&self,
user_key: &str,
body: &UserMakeAdmin
) -> Result<()>

pub async fn photos_update(
&self,
user_key: &str,
body: &UserPhoto
) -> Result<UserPhoto>

pub async fn photos_patch(
&self,
user_key: &str,
body: &UserPhoto
) -> Result<UserPhoto>

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,