Crate gsuite_api

A rust library for interacting with the GSuite APIs.

For more information, the GSuite Directory API is documented at developers.google.com/admin-sdk/directory/v1/reference and the Google Groups settings API is documented at developers.google.com/admin-sdk/groups-settings/v1/reference/groups.

Example:

use std::env;

use gsuite_api::GSuite;
use yup_oauth2::{read_service_account_key, ServiceAccountAuthenticator};

async fn get_users() {
 // Get the GSuite credentials file.
 let gsuite_credential_file = env::var("GADMIN_CREDENTIAL_FILE").unwrap();
 let gsuite_subject = env::var("GADMIN_SUBJECT").unwrap();
 let gsuite_secret = read_service_account_key(gsuite_credential_file).await.expect("failed to read gsuite credential file");
 let auth = ServiceAccountAuthenticator::builder(gsuite_secret).subject(gsuite_subject.to_string()).build().await.expect("failed to create authenticator");

 // Add the scopes to the secret and get the token.
 let token = auth.token(&[
     "https://www.googleapis.com/auth/admin.directory.group",
     "https://www.googleapis.com/auth/admin.directory.resource.calendar",
     "https://www.googleapis.com/auth/admin.directory.user",
     "https://www.googleapis.com/auth/apps.groups.settings",
 ]).await.expect("failed to get token");

 if token.as_str().is_empty() {
     panic!("empty token is not valid");
 }

 // Initialize the GSuite client.
 let gsuite_client = GSuite::new("customer_id", "domain", token);

 // List users.
 let users = gsuite_client.list_users().await;

 // Iterate over the users.
 for user in users {
    println!("{:?}", user);
 }
}

Structs

Building	A building.
BuildingAddress	A building's address.
BuildingCoordinates	A building's coordinates.
CalendarFeature	A feature of a calendar.
CalendarFeatures	A calendar's features.
CalendarResource	A calendar resource.
GSuite	Entrypoint for interacting with the GSuite APIs.
Group	A Google group.
GroupSettings	A Google group's settings.
User	A user.
UserCustomProperties	Custom properties for a user.
UserEmail	A user's email.
UserGender	A user's gender.
UserLocation	A user's location.
UserName	A user's name.
UserPhone	A user's phone.
UserSSHKey	A user's ssh key.

Functions

generate_password

Generate a random string that we can use as a temporary password for new users when we set up their account.