### Install http-server Package

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/js

Install the http-server package to serve your local files. This is a prerequisite for running the quickstart application.

```bash
npm install http-server

```

--------------------------------

### End-to-End C# Example for Domain Verification and Workspace Setup

Source: https://developers.google.com/workspace/admin/reseller/v1/codelab/end-to-end?hl=hi

This comprehensive C# code snippet covers the entire process of setting up a Google Workspace customer, including domain verification, customer creation, admin user setup, and subscription provisioning. It requires the Reseller API, Directory API, and Site Verification API to be enabled.

```csharp
var resellerService = new ResellerService(new BaseClientService.Initializer
{
    HttpClientInitializer = credential,
});

var directoryService = new DirectoryService(new BaseClientService.Initializer
{
    HttpClientInitializer = credential,
});

var verificationService = new SiteVerificationService(new BaseClientService.Initializer
{
    HttpClientInitializer = credential,
});

// Retrieve the site verification token and place it according to:
// https://developers.google.com/site-verification/v1/getting_started#tokens
SiteVerificationWebResourceGettokenRequest.SiteData getTokenSite =
    new SiteVerificationWebResourceGettokenRequest.SiteData()
    {
        Type = "INET_DOMAIN",
        Identifier = CUSTOMER_DOMAIN
    };

SiteVerificationWebResourceGettokenRequest request = 
    new SiteVerificationWebResourceGettokenRequest()
    {
        VerificationMethod = "DNS_TXT",
        Site = getTokenSite
    };

SiteVerificationWebResourceGettokenResponse getTokenResponse =
    verificationService.WebResource.GetToken(request).Execute();
Console.WriteLine("Site Verification Token: {0}", getTokenResponse.Token);

// Determine if customer domain already has Google Workspace
try
{
    resellerService.Customers.Get(CUSTOMER_DOMAIN).Execute();
    Console.WriteLine("Customer already exists if call succeeds");
    Environment.Exit(0);
}
catch (Google.GoogleApiException e) {
    if (e.Error.Code == 404)
    {
        Console.WriteLine("Domain available for Google Workspace creation");
    } else throw e;
}

// Create customer resource
Address address = new Address()
{
    ContactName = "Marty McFly",
    OrganizationName = "Acme Corp",
    CountryCode = "US",
    PostalCode = "10009"
};

Customer customer = new Customer()
{
    CustomerDomain = CUSTOMER_DOMAIN,
    AlternateEmail = "marty.mcfly@gmail.com",
    PostalAddress = address
};

Customer customerResponse = resellerService.Customers.Insert(customer).Execute();
Console.WriteLine("Created Customer:\n{0}", customerResponse);

// Create first admin user
String userEmail = "marty.mcfly@" + CUSTOMER_DOMAIN;

UserName name = new UserName()
{
    GivenName = "Marty",
    FamilyName = "McFly"
};

User user = new User()
{
    PrimaryEmail = userEmail,
    Password = "TimeCircuit88",
    Name = name
};

User userResponse = directoryService.Users.Insert(user).Execute();
Console.WriteLine("Created User:\n{0}", userResponse);

// Promote user to admin status
UserMakeAdmin admin = new UserMakeAdmin()
{
    Status = true
};
directoryService.Users.MakeAdmin(admin, userEmail).Execute();
Console.WriteLine("User promoted to Admin");

// Create subscription resource
Seats seats = new Seats()
{
    NumberOfSeats = 5
};

Subscription.PlanData plan = new Subscription.PlanData()
{
    PlanName = "ANNUAL_YEARLY_PAY"
};

RenewalSettings renewalSettings = new RenewalSettings()
{
    RenewalType = "RENEW_CURRENT_USERS_MONTHLY_PAY"
};

Subscription subscription = new Subscription()
{
    CustomerId = CUSTOMER_DOMAIN,
    Seats = seats,
    Plan = plan,
    SkuId = "1010020027",
    RenewalSettings = renewalSettings
};

Subscription subscriptionResponse = resellerService.Subscriptions
    .Insert(subscription, CUSTOMER_DOMAIN).Execute();
Console.WriteLine("Created Subscription:\n" + subscriptionResponse);

// Verify domain and designate domain owners
SiteVerificationWebResourceResource.SiteData verifySite =
      new SiteVerificationWebResourceResource.SiteData()
      {
          Identifier = CUSTOMER_DOMAIN,
          Type = "INET_DOMAIN"
      };

string[] owners = { userEmail };

SiteVerificationWebResourceResource resource =
  new SiteVerificationWebResourceResource()
  {
      Site = verifySite,
      Owners = owners
  };

SiteVerificationWebResourceResource verifyResponse =
    verificationService.WebResource.Insert(resource, "DNS_TXT").Execute();
Console.WriteLine("Site Verification Web Resource:\n" + verifyResponse);

```

--------------------------------

### Install Alert Center API Client Library for Python Manually

Source: https://developers.google.com/workspace/admin/alertcenter/guides/libraries

Manually install the Python client library by downloading, unpacking, and running the setup script.

```bash
python setup.py install
```

--------------------------------

### HTML Structure for Reseller API Quickstart

Source: https://developers.google.com/workspace/admin/reseller/v1/quickstart/js

This HTML file sets up the basic structure for the Google Workspace Reseller API quickstart, including buttons for authorization and sign-out, and a content area to display results. It also includes necessary JavaScript includes and initial setup.

```html
<!DOCTYPE html>
<html>
  <head>
    <title>Google Workspace Reseller API Quickstart</title>
    <meta charset="utf-8" />
  </head>
  <body>
    <p>Google WOrkspace Reseller API Quickstart</p>

    <!--Add buttons to initiate auth sequence and sign out-->
    <button id="authorize_button" onclick="handleAuthClick()">Authorize</button>
    <button id="signout_button" onclick="handleSignoutClick()">Sign Out</button>

    <pre id="content" style="white-space: pre-wrap;"></pre>

    <script type="text/javascript">
      /* exported gapiLoaded */
      /* exported gisLoaded */
      /* exported handleAuthClick */
      /* exported handleSignoutClick */

      // TODO(developer): Set to client ID and API key from the Developer Console
      const CLIENT_ID = '<YOUR_CLIENT_ID>';
      const API_KEY = '<YOUR_API_KEY>';

      // Discovery doc URL for APIs used by the quickstart
      const DISCOVERY_DOC = 'https://www.googleapis.com/discovery/v1/apis/reseller/v1/rest';

      // Authorization scopes required by the API; multiple scopes can be
      // included, separated by spaces.
      const SCOPES = 'https://www.googleapis.com/auth/apps.order';

      let tokenClient;
      let gapiInited = false;
      let gisInited = false;

      document.getElementById('authorize_button').style.visibility = 'hidden';
      document.getElementById('signout_button').style.visibility = 'hidden';

      /**
       * Callback after api.js is loaded.
       */
      function gapiLoaded() {
        gapi.load('client', initializeGapiClient);
      }

      /**
       * Callback after the API client is loaded. Loads the
       * discovery doc to initialize the API.
       */
      async function initializeGapiClient() {
        await gapi.client.init({
          apiKey: API_KEY,
          discoveryDocs: [DISCOVERY_DOC],
        });
        gapiInited = true;
        maybeEnableButtons();
      }

      /**
       * Callback after Google Identity Services are loaded.
       */
      function gisLoaded() {
        tokenClient = google.accounts.oauth2.initTokenClient({
          client_id: CLIENT_ID,
          scope: SCOPES,
          callback: '', // defined later
        });
        gisInited = true;
        maybeEnableButtons();
      }

      /**
       * Enables user interaction after all libraries are loaded.
       */
      function maybeEnableButtons() {
        if (gapiInited && gisInited) {
          document.getElementById('authorize_button').style.visibility = 'visible';
        }
      }

      /**
       *  Sign in the user upon button click.
       */
      function handleAuthClick() {
        tokenClient.callback = async (resp) => {
          if (resp.error !== undefined) {
            throw (resp);
          }
          document.getElementById('signout_button').style.visibility = 'visible';
          document.getElementById('authorize_button').innerText = 'Refresh';
          await listSubscriptions();
        };

        if (gapi.client.getToken() === null) {
          // Prompt the user to select a Google Account and ask for consent to share their data
          // when establishing a new session.
          tokenClient.requestAccessToken({prompt: 'consent'});
        } else {
          // Skip display of account chooser and consent dialog for an existing session.
          tokenClient.requestAccessToken({prompt: ''});
        }
      }

      /**
       *  Sign out the user upon button click.
       */
      function handleSignoutClick() {
        const token = gapi.client.getToken();
        if (token !== null) {
          google.accounts.oauth2.revoke(token.access_token);
          gapi.client.setToken('');
          document.getElementById('content').innerText = '';
          document.getElementById('authorize_button').innerText = 'Authorize';
          document.getElementById('signout_button').style.visibility = 'hidden';
        }
      }

      /**
       * Print first ten subscriptions.
       */
      async function listSubscriptions() {
        let response;
        try {
          response = await gapi.client.reseller.subscriptions.list({
            'maxResults': 10,
          });
        } catch (err) {
          document.getElementById('content').innerText = err.message;
          return;
        }

        const subscriptions = response.result.subscriptions;
        if (!subscriptions || subscriptions.length == 0) {
          document.getElementById('content').innerText = 'No subscriptions found.';
          return;
        }
        // Flatten to string to display
        const output = subscriptions.reduce(
            (str, subscription) => {
              const customer = subscription.customerId;
              const sku = subscription.skuId;
              const plan = subscription.plan.planName;

```

--------------------------------

### Retrieve specific organizational units example

Source: https://developers.google.com/workspace/admin/directory/v1/guides/manage-org-units.html

Example GET request to retrieve all organizational units starting from the '/corp' organizational unit. Ensure proper authorization.

```HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits?orgUnitPath=/corp&type=all
```

--------------------------------

### Build and Run Go Sample

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/go

Compiles and executes the Go quickstart application. This command initiates the API interaction and the OAuth 2.0 authorization flow if it's the first run.

```bash
go run quickstart.go
```

--------------------------------

### Example GET request for successful logins and authorized apps

Source: https://developers.google.com/workspace/admin/reports/v1/guides/manage-usage-customers

This example gets a report with the total of all successful logins to your account in the past 30 days and a list of authorized applications, with the number of user authorizations per application, starting 2013-03-03. The `maxResults` query string shows this report returns two events per report page.

```HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03
?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2

```

--------------------------------

### Reseller API Go Quickstart Application

Source: https://developers.google.com/workspace/admin/reseller/v1/quickstart/go

This Go program demonstrates how to authenticate with the Reseller API using OAuth2, retrieve an authenticated client, and list the first 10 customer subscriptions. It handles token storage and retrieval for subsequent runs.

```go
package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"

	"golang.org/x/oauth2"
	"golang.org/x/oauth2/google"
	"google.golang.org/api/option"
	"google.golang.org/api/reseller/v1"
)

// Retrieve a token, saves the token, then returns the generated client.
func getClient(config *oauth2.Config) *http.Client {
	// The file token.json stores the user's access and refresh tokens, and is
	// created automatically when the authorization flow completes for the first
	// time.
	tokFile := "token.json"
	tok, err := tokenFromFile(tokFile)
	if err != nil {
		tok = getTokenFromWeb(config)
		saveToken(tokFile, tok)
	}
	return config.Client(context.Background(), tok)
}

// Request a token from the web, then returns the retrieved token.
func getTokenFromWeb(config *oauth2.Config) *oauth2.Token {
	authURL := config.AuthCodeURL("state-token", oauth2.AccessTypeOffline)
	fmt.Printf("Go to the following link in your browser then type the " +
		"authorization code: \n%v\n", authURL)

	var authCode string
	if _, err := fmt.Scan(&authCode); err != nil {
		log.Fatalf("Unable to read authorization code: %v", err)
	}

	tok, err := config.Exchange(context.TODO(), authCode)
	if err != nil {
		log.Fatalf("Unable to retrieve token from web: %v", err)
	}
	return tok
}

// Retrieves a token from a local file.
func tokenFromFile(file string) (*oauth2.Token, error) {
	f, err := os.Open(file)
	if err != nil {
		return nil, err
	}
	defer f.Close()
	tok := &oauth2.Token{}
	err = json.NewDecoder(f).Decode(tok)
	return tok, err
}

// Saves a token to a file path.
func saveToken(path string, token *oauth2.Token) {
	fmt.Printf("Saving credential file to: %s\n", path)
	f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600)
	if err != nil {
		log.Fatalf("Unable to cache oauth token: %v", err)
	}
	defer f.Close()
	json.NewEncoder(f).Encode(token)
}

func main() {
	ctx := context.Background()
	b, err := os.ReadFile("credentials.json")
	if err != nil {
		log.Fatalf("Unable to read client secret file: %v", err)
	}

	// If modifying these scopes, delete your previously saved token.json.
	config, err := google.ConfigFromJSON(b, reseller.AppsOrderScope)
	if err != nil {
		log.Fatalf("Unable to parse client secret file to config: %v", err)
	}
	client := getClient(config)

	srv, err := reseller.NewService(ctx, option.WithHTTPClient(client))
	if err != nil {
		log.Fatalf("Unable to retrieve reseller Client %v", err)
	}

	r, err := srv.Subscriptions.List().MaxResults(10).Do()
	if err != nil {
		log.Fatalf("Unable to retrieve subscriptions. %v", err)
	}

	if len(r.Subscriptions) == 0 {
		fmt.Println("No subscriptions found.")
	} else {
		fmt.Println("Subscriptions:")
		for _, s := range r.Subscriptions {
			fmt.Printf("%s (%s, %s)\n", s.CustomerId, s.SkuId, s.Plan.PlanName)
		}
	}
}

```

--------------------------------

### Retrieve a ChromeOS Device GET Request (Example)

Source: https://developers.google.com/workspace/admin/directory/v1/guides/manage-chrome-devices.html

An example GET request to retrieve a ChromeOS device with a full projection.

```http
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

```

--------------------------------

### Create Working Directory

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/go

Creates a new directory for the project. This is the first step in setting up your Go quickstart environment.

```bash
mkdir quickstart
```

--------------------------------

### Python Quickstart Application

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/python

This Python script demonstrates basic usage of the Admin SDK Directory API. It prints the emails and names of the first 10 users in the domain after handling authentication.

```python
import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file token.json.
SCOPES = ["https://www.googleapis.com/auth/admin.directory.user"]


def main():
  """Shows basic usage of the Admin SDK Directory API.
  Prints the emails and names of the first 10 users in the domain.
  """
  creds = None
  # The file token.json stores the user's access and refresh tokens, and is
  # created automatically when the authorization flow completes for the first
  # time.
  if os.path.exists("token.json"):
    creds = Credentials.from_authorized_user_file("token.json", SCOPES)
  # If there are no (valid) credentials available, let the user log in.
  if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
      creds.refresh(Request())
    else:
      flow = InstalledAppFlow.from_client_secrets_file(
          "credentials.json", SCOPES
      )
      creds = flow.run_local_server(port=0)
    # Save the credentials for the next run
    with open("token.json", "w") as token:
      token.write(creds.to_json())

  service = build("admin", "directory_v1", credentials=creds)

  # Call the Admin SDK Directory API
  print("Getting the first 10 users in the domain")
  results = (
      service.users()
      .list(customer="my_customer", maxResults=10, orderBy="email")
      .execute()
  )
  users = results.get("users", [])

  if not users:
    print("No users in the domain.")
  else:
    print("Users:")
    for user in users:
      print(f"{user['primaryEmail']} ({user['name']['fullName']})")


if __name__ == "__main__":
  main()

```

--------------------------------

### Retrieve Specific Group Settings Example

Source: https://developers.google.com/workspace/admin/groups-settings/manage

This example shows how to retrieve the settings for the salesgroup@example.com group using a GET request.

```HTTP
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com

```

--------------------------------

### Example HTTP Request for Photo

Source: https://developers.google.com/workspace/admin/domain-shared-contacts/get-photo-shared-contacts

This is an example of the HTTP request to get the latest version of a contact's photo, using the href from the link element.

```HTTP
GET https://google.com/m8/feeds/photos/media/example.com/c9012de
```

--------------------------------

### Java: Initialize Reseller, Directory, and Site Verification Services

Source: https://developers.google.com/workspace/admin/reseller/v1/codelab/end-to-end?hl=ko

This Java example demonstrates how to set up authenticated clients for the Reseller, Directory, and Site Verification APIs using service account credentials and Google's client libraries.

```java
// OAuth2 and HTTP
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpResponseException;
import com.google.api.client.json.jackson2.JacksonFactory;
// Directory API
import com.google.api.services.admin.directory.Directory;
import com.google.api.services.admin.directory.DirectoryScopes;
import com.google.api.services.admin.directory.model.User;
import com.google.api.services.admin.directory.model.UserMakeAdmin;
import com.google.api.services.admin.directory.model.UserName;
// Reseller API
import com.google.api.services.reseller.Reseller;
import com.google.api.services.reseller.ResellerScopes;
import com.google.api.services.reseller.model.Address;
import com.google.api.services.reseller.model.Customer;
import com.google.api.services.reseller.model.RenewalSettings;
import com.google.api.services.reseller.model.Seats;
import com.google.api.services.reseller.model.Subscription;
// Site Verification API
import com.google.api.services.siteVerification.SiteVerification;
import com.google.api.services.siteVerification.SiteVerificationScopes;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceGettokenRequest;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceGettokenResponse;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceResource;
// Java library imports
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Arrays;
import java.util.List;

/**
 * This is a basic example of provisioning a Google Workspace customer.
 */
public class CodelabExample {
  // Full List of scopes:
  // https://developers.google.com/identity/protocols/googlescopes
  private static final List<String> OAUTH2_SCOPES = Arrays.asList(
    ResellerScopes.APPS_ORDER,
    SiteVerificationScopes.SITEVERIFICATION,
    DirectoryScopes.ADMIN_DIRECTORY_USER
  );

  /***************** REPLACE WITH YOUR OWN VALUES ********************************/
  public static final String JSON_PRIVATE_KEY_FILE = "path/to/json_key_file.json";
  public static final String RESELLER_ADMIN_USER = "admin@yourresellerdomain.com";
  public static final String CUSTOMER_DOMAIN = "example.com";
  public static final String CUSTOMER_SITE = "https://www.example.com/";
  /*******************************************************************************/

  public static void main(String[] args)
      throws IOException, GeneralSecurityException, FileNotFoundException {
    // Instantiate services with authenticated credentials
    GoogleCredential jsonCredentials = GoogleCredential
      .fromStream(new FileInputStream(JSON_PRIVATE_KEY_FILE));
    GoogleCredential credentials = new GoogleCredential.Builder()
      .setTransport(GoogleNetHttpTransport.newTrustedTransport())
      .setJsonFactory(JacksonFactory.getDefaultInstance())
      .setServiceAccountScopes(OAUTH2_SCOPES)
      .setServiceAccountUser(RESELLER_ADMIN_USER)
      .setServiceAccountPrivateKey(jsonCredentials.getServiceAccountPrivateKey())
      .setServiceAccountId(jsonCredentials.getServiceAccountId())
      .build();

    Reseller resellerService = new Reseller.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();

    Directory directoryService = new Directory.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();

    SiteVerification verificationService = new SiteVerification.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();
```

--------------------------------

### Example Shared Contact Photo Link

Source: https://developers.google.com/workspace/admin/domain-shared-contacts/get-photo-shared-contacts

This is an example of a contact's photo link element. The href attribute contains the URL to use in your GET request.

```HTML
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
        href="https://google.com/m8/feeds/photos/media/example.com/c9012de"/>
```

--------------------------------

### PHP: Setup Google Client and Services

Source: https://developers.google.com/workspace/admin/reseller/v1/codelab/end-to-end?hl=ko

Initializes the Google Client, sets authentication, and creates service objects for Reseller, Directory, and Site Verification APIs. Ensure you replace placeholder values with your own.

```php
// https://developers.google.com/api-client-library/php/
require_once 'vendor/autoload.php';

// Full List of scopes: 
// https://developers.google.com/identity/protocols/googlescopes
$OAUTH2_SCOPES = [
  Google_Service_Reseller::APPS_ORDER,
  Google_Service_SiteVerification::SITEVERIFICATION,
  Google_Service_Directory::ADMIN_DIRECTORY_USER,
];

######### REPLACE WITH YOUR OWN VALUES ###############
$JSON_PRIVATE_KEY_FILE = 'path/to/json_key_file.json';
$RESELLER_ADMIN_USER = 'admin@yourresellerdomain.com';
$CUSTOMER_DOMAIN = 'example.com';
$CUSTOMER_SITE = 'https://www.example.com/';
######################################################

$client = new Google_Client();
$client->setAuthConfig($JSON_PRIVATE_KEY_FILE);
$client->setSubject($RESELLER_ADMIN_USER);
$client->setScopes($OAUTH2_SCOPES);

$resellerService = new Google_Service_Reseller($client);
$directoryService = new Google_Service_Directory($client);
$verificationService = new Google_Service_SiteVerification($client);
```

--------------------------------

### Retrieve Specific User Photo Thumbnail (Example)

Source: https://developers.google.com/workspace/admin/directory/v1/guides/manage-users.html

Example GET request to retrieve the photo thumbnail for a specific user, 'liz@example.com'. Requires authorization.

```HTTP
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/photos/thumbnail

```

--------------------------------

### Go Quickstart Application Code

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/go

The main Go program for the Directory API quickstart. It handles authentication, retrieves a list of users, and prints their details. Ensure you have a 'credentials.json' file in the same directory.

```go
package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"

	"golang.org/x/oauth2"
	"golang.org/x/oauth2/google"
	admin "google.golang.org/api/admin/directory/v1"
	"google.golang.org/api/option"
)

// Retrieve a token, saves the token, then returns the generated client.
func getClient(config *oauth2.Config) *http.Client {
	// The file token.json stores the user's access and refresh tokens, and is
	// created automatically when the authorization flow completes for the first
	// time.
	tokFile := "token.json"
	tok, err := tokenFromFile(tokFile)
	if err != nil {
		tok = getTokenFromWeb(config)
		saveToken(tokFile, tok)
	}
	return config.Client(context.Background(), tok)
}

// Request a token from the web, then returns the retrieved token.
func getTokenFromWeb(config *oauth2.Config) *oauth2.Token {
	authURL := config.AuthCodeURL("state-token", oauth2.AccessTypeOffline)
	fmt.Printf("Go to the following link in your browser then type the " +
		"authorization code: \n%v\n", authURL)

	var authCode string
	if _, err := fmt.Scan(&authCode); err != nil {
		log.Fatalf("Unable to read authorization code: %v", err)
	}

	tok, err := config.Exchange(context.TODO(), authCode)
	if err != nil {
		log.Fatalf("Unable to retrieve token from web: %v", err)
	}
	return tok
}

// Retrieves a token from a local file.
func tokenFromFile(file string) (*oauth2.Token, error) {
	f, err := os.Open(file)
	if err != nil {
		return nil, err
	}
	defer f.Close()
	tok := &oauth2.Token{}
	err = json.NewDecoder(f).Decode(tok)
	return tok, err
}

// Saves a token to a file path.
func saveToken(path string, token *oauth2.Token) {
	fmt.Printf("Saving credential file to: %s\n", path)
	f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600)
	if err != nil {
		log.Fatalf("Unable to cache oauth token: %v", err)
	}
	defer f.Close()
	json.NewEncoder(f).Encode(token)
}

func main() {
	ctx := context.Background()
	b, err := os.ReadFile("credentials.json")
	if err != nil {
		log.Fatalf("Unable to read client secret file: %v", err)
	}

	// If modifying these scopes, delete your previously saved token.json.
	config, err := google.ConfigFromJSON(b, admin.AdminDirectoryUserReadonlyScope)
	if err != nil {
		log.Fatalf("Unable to parse client secret file to config: %v", err)
	}
	client := getClient(config)

	srv, err := admin.NewService(ctx, option.WithHTTPClient(client))
	if err != nil {
		log.Fatalf("Unable to retrieve directory Client %v", err)
	}

	r, err := srv.Users.List().Customer("my_customer").MaxResults(10).
		OrderBy("email").Do()
	if err != nil {
		log.Fatalf("Unable to retrieve users in domain: %v", err)
	}

	if len(r.Users) == 0 {
		fmt.Print("No users found.\n")
	} else {
		fmt.Print("Users:\n")
		for _, u := range r.Users {
			fmt.Printf("%s (%s)\n", u.PrimaryEmail, u.Name.FullName)
		}
	}
}

```

--------------------------------

### C#: Initialize Reseller, Directory, and Site Verification Services

Source: https://developers.google.com/workspace/admin/reseller/v1/codelab/end-to-end?hl=ko

This C# example shows how to initialize clients for the Reseller, Directory, and Site Verification APIs using Google's .NET client libraries.

```csharp
// OAuth2 and HTTP
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
// Reseller API
using Google.Apis.Reseller.v1;
using Google.Apis.Reseller.v1.Data;
// Directory API
using Google.Apis.Admin.Directory.directory_v1;
using User = Google.Apis.Admin.Directory.directory_v1.Data.User;

```

--------------------------------

### Retrieve All Deleted Users in an Account (Example)

Source: https://developers.google.com/workspace/admin/directory/v1/guides/manage-users.html

Example GET request for an account administrator to retrieve all deleted users within the last 20 days. Requires authorization.

```HTTP
GET https://admin.googleapis.com/admin/directory/v1/users?customer=my_customer&showDeleted=true

```

--------------------------------

### Install Alert Center API Client Library for Python using Setuptools

Source: https://developers.google.com/workspace/admin/alertcenter/guides/libraries

Use Setuptools to install or upgrade the Google API Client Library for Python if pip is not your preferred package manager.

```bash
easy_install --upgrade google-api-python-client
```

--------------------------------

### Get Started Account Migration Events

Source: https://developers.google.com/workspace/admin/reports/v1/appendix/activity/graduation

Retrieve events for started user account data migrations to a personal account. This sample demonstrates filtering by event name and application.

```REST
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/**graduation**?eventName=**STARTED_ACCOUNT_MIGRATION**&maxResults=10&access_token=YOUR_ACCESS_TOKEN
```

--------------------------------

### HTML Structure for Reseller API Quickstart

Source: https://developers.google.com/workspace/admin/reseller/v1/quickstart/js

This HTML includes script tags for loading Google API client libraries and a placeholder for displaying output. Replace YOUR_CLIENT_ID and YOUR_API_KEY with your actual credentials.

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <style type="text/css">
      .hidden { display: none; }
    </style>
  </head>
  <body>
    <h1>Reseller API Quickstart</h1>
    <p>This sample requires you to have a client ID and API key. See the <a href="https://developers.google.com/admin-sdk/reseller/v1/quickstart/js">Reseller API documentation</a> for more information.</p>
    <button id="authorize_button" style="display: none">Authorize</button>
    <button id="signout_button" style="display: none">Sign Out</button>
    <pre id="content" style="white-space: pre-wrap"></pre>
    <script type="text/javascript">
      // TODO(developer): Set to client ID found in the Google Cloud Console.
      const CLIENT_ID = 'YOUR_CLIENT_ID';

      // TODO(developer): Set to API key found in the Google Cloud Console.
      const API_KEY = 'YOUR_API_KEY';

      // Discovery docs to enable the Reseller API.
      const discoveryDocs = "https://www.googleapis.com/discovery/v1/apis/reseller/v1/rest";

      // Authorization scopes required by the API. 
      // 
      // See https://developers.google.com/identity/protocols/googlesignin/web-oauth
      // for further details on scopes.
      const scopes = 'https://www.googleapis.com/auth/apps.order.readonly';

      let tokenClient;
      let gapiInited = false;
      let gisInited = false;

      /**
       * Callback after the API client is loaded.
       * This is called by gapi.load() function.
       */
      function gapiLoaded() {
        gapi.load('client', initializeGapiClient);
      }

      /**
       * Callback client is ready. Initialize the Google API client.
       */
      async function initializeGapiClient() {
        await gapi.client.init({
          apiKey: API_KEY,
          discoveryDocs: discoveryDocs,
        });
        gapiInited = true;
        maybeEnableButtons();
      }

      /**
       * Callback after the API client is loaded. Calls the init method to load the API.
       */
      function gisLoaded() {
        tokenClient = google.accounts.oauth2.initTokenClient({
          client_id: CLIENT_ID,
          scope: scopes,
          callback: '', // defined later
        });
        gisInited = true;
        maybeEnableButtons();
      }

      /**
       * Enables user interaction after all libraries data have loaded.
       */
      function maybeEnableButtons() {
        if (gapiInited && gisInited) {
          document.getElementById('authorize_button').style.visibility = 'visible';
        }
      }

      /**
       * Enables the #authorize_button and then calls the API.
       */
      function handleAuthClick() {
        tokenClient.callback = async (resp) => {
          if (resp.error !== undefined) {
            throw (resp);
          }
          document.getElementById('signout_button').style.visibility = 'visible';
          document.getElementById('authorize_button').innerText = 'Refresh';
          await listCustomers();
        };

        if (gapi.client.getToken() === null) {
          // Prompt the user to select a Google Account and ask for consent to share their data
          // when establishing a new or re-establishing a current API connection.
          tokenClient.requestAccessToken({ prompt: 'consent' });
        } else {
          // Skip display of account chooser and consent dialog for an existing session.
          tokenClient.requestAccessToken({ prompt: '' });
        }
      }

      /**
       * Prints all customers to the screen.
       */
      async function listCustomers() {
        let output = 'Subscriptions:\n';
        try {
          const response = await gapi.client.reseller.customers.list({
            customerId: 'my_customer_id',
            maxResults: 10,
          });
          // Handle the results, like printing them to the page.
          const customers = response.result.customers;
          if (!customers || customers.length == 0) {
            output += 'No customers found.';
          }
          customers.forEach(customer => {
            output += `${customer.customerName} (${customer.customerDomain})
`;
          });
        } catch (err) {
          output += `Error: ${err.message}`;
        }
        document.getElementById('content').innerText = output;
        return;
      }

      /**
       * Sign out the user upon button click.
       */
      function handleSignoutClick() {
        const token = gapi.client.getToken();
        if (token !== null) {
          google.accounts.oauth2.revoke(token.access_token, () => {
            console.log('User signed out.');
          });
          gapi.client.setToken('');
          document.getElementById('content').innerText = '';
          document.getElementById('authorize_button').innerText = 'Authorize';
          document.getElementById('signout_button').style.visibility = 'hidden';
        }
      }
    </script>
    <script async defer src="https://apis.google.com/js/api.js" onload="gapiLoaded()"></script>
    <script async defer src="https://accounts.google.com/gsi/client" onload="gisLoaded()"></script>
  </body>
</html>
```

--------------------------------

### Run the Python Quickstart Application

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/python

Execute the Python script from your working directory to run the quickstart application. This will initiate the OAuth 2.0 authorization flow if credentials are not already stored.

```bash
python3 quickstart.py

```

--------------------------------

### Example Request for a Specific Mobile Device

Source: https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices.html

This is an example of a GET request to retrieve a specific mobile device's details using its resource ID and requesting the FULL projection.

```HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL
```

--------------------------------

### Sample Request for Rules Activity

Source: https://developers.google.com/workspace/admin/reports/v1/appendix/activity/rules

Example of a GET request to retrieve activity related to DLP rules.

```APIDOC
## GET /admin/reports/v1/activity/users/all/applications/**rules**

### Description
Retrieves activity logs for DLP rules, specifically filtering for events where a label field value was changed.

### Method
GET

### Endpoint
`https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/**rules**`

### Query Parameters
* **eventName** (string) - Required - Filters activity for a specific event, e.g., `label_field_value_changed`.
* **maxResults** (integer) - Optional - The maximum number of results to return.
* **access_token** (string) - Required - Your OAuth 2.0 access token.

### Response Example (Conceptual)
```json
{
  "kind": "admin#reports#activity",
  "items": [
    {
      "id": {
        "time": "2023-10-27T10:00:00.000Z",
        "uniqueQualifier": "..."
      },
      "actor": {
        "email": "admin@example.com",
        "key": "..."
      },
      "events": [
        {
          "name": "label_field_value_changed",
          "parameters": [
            {
              "name": "label_field",
              "value": "sensitive_data"
            },
            {
              "name": "label_title",
              "value": "Confidential"
            },
            {
              "name": "old_value",
              "value": "Internal"
            },
            {
              "name": "new_value",
              "value": "Restricted"
            }
          ]
        }
      ]
    }
  ]
}
```
```

--------------------------------

### Java: Instantiate Reseller, Directory, and Site Verification Services

Source: https://developers.google.com/workspace/admin/reseller/v1/codelab/end-to-end?hl=ar

Sets up authenticated credentials and instantiates the Reseller, Directory, and Site Verification services. This example requires replacing placeholder values for the JSON private key file and reseller admin user.

```java
// OAuth2 and HTTP
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpResponseException;
import com.google.api.client.json.jackson2.JacksonFactory;
// Directory API
import com.google.api.services.admin.directory.Directory;
import com.google.api.services.admin.directory.DirectoryScopes;
import com.google.api.services.admin.directory.model.User;
import com.google.api.services.admin.directory.model.UserMakeAdmin;
import com.google.api.services.admin.directory.model.UserName;
// Reseller API
import com.google.api.services.reseller.Reseller;
import com.google.api.services.reseller.ResellerScopes;
import com.google.api.services.reseller.model.Address;
import com.google.api.services.reseller.model.Customer;
import com.google.api.services.reseller.model.RenewalSettings;
import com.google.api.services.reseller.model.Seats;
import com.google.api.services.reseller.model.Subscription;
// Site Verification API
import com.google.api.services.siteVerification.SiteVerification;
import com.google.api.services.siteVerification.SiteVerificationScopes;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceGettokenRequest;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceGettokenResponse;
import com.google.api.services.siteVerification.model.SiteVerificationWebResourceResource;
// Java library imports
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Arrays;
import java.util.List;

/**
 * This is a basic example of provisioning a Google Workspace customer.
 */
public class CodelabExample {
  // Full List of scopes:
  // https://developers.google.com/identity/protocols/googlescopes
  private static final List<String> OAUTH2_SCOPES = Arrays.asList(
    ResellerScopes.APPS_ORDER,
    SiteVerificationScopes.SITEVERIFICATION,
    DirectoryScopes.ADMIN_DIRECTORY_USER
  );

  /***************** REPLACE WITH YOUR OWN VALUES ********************************/
  public static final String JSON_PRIVATE_KEY_FILE = "path/to/json_key_file.json";
  public static final String RESELLER_ADMIN_USER = "admin@yourresellerdomain.com";
  public static final String CUSTOMER_DOMAIN = "example.com";
  public static final String CUSTOMER_SITE = "https://www.example.com/";
  /*******************************************************************************/

  public static void main(String[] args)
      throws IOException, GeneralSecurityException, FileNotFoundException {
    // Instantiate services with authenticated credentials
    GoogleCredential jsonCredentials = GoogleCredential
      .fromStream(new FileInputStream(JSON_PRIVATE_KEY_FILE));
    GoogleCredential credentials = new GoogleCredential.Builder()
      .setTransport(GoogleNetHttpTransport.newTrustedTransport())
      .setJsonFactory(JacksonFactory.getDefaultInstance())
      .setServiceAccountScopes(OAUTH2_SCOPES)
      .setServiceAccountUser(RESELLER_ADMIN_USER)
      .setServiceAccountPrivateKey(jsonCredentials.getServiceAccountPrivateKey())
      .setServiceAccountId(jsonCredentials.getServiceAccountId())
      .build();

    Reseller resellerService = new Reseller.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();

    Directory directoryService = new Directory.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();

    SiteVerification verificationService = new SiteVerification.Builder(
        credentials.getTransport(),
        credentials.getJsonFactory(),
        credentials).setApplicationName("Google Workspace Creator").build();

```

--------------------------------

### Get All Parameters for Gplus Communities

Source: https://developers.google.com/workspace/admin/reports/v1/guides/manage-usage-entities

This example retrieves a report containing all parameters for all gplus_communities entities for a specific date.

```HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all
/dates/2017-12-11
```

--------------------------------

### HTML Structure for Directory API Quickstart

Source: https://developers.google.com/workspace/admin/directory/v1/quickstart/js

This HTML file sets up the basic structure for the Directory API quickstart, including buttons for authorization and sign-out, and a preformatted area to display content. It also includes script tags for loading necessary Google APIs.

```html
<!DOCTYPE html>
<html>
  <head>
    <title>Directory API Quickstart</title>
    <meta charset="utf-8" />
  </head>
  <body>
    <p>Directory API Quickstart</p>

    <!--Add buttons to initiate auth sequence and sign out-->
    <button id="authorize_button" onclick="handleAuthClick()">Authorize</button>
    <button id="signout_button" onclick="handleSignoutClick()">Sign Out</button>

    <pre id="content" style="white-space: pre-wrap;"></pre>

    <script type="text/javascript">
      /* exported gapiLoaded */
      /* exported gisLoaded */
      /* exported handleAuthClick */
      /* exported handleSignoutClick */

      // TODO(developer): Set to client ID and API key from the Developer Console
      const CLIENT_ID = '<YOUR_CLIENT_ID>';
      const API_KEY = '<YOUR_API_KEY>';

      // Discovery doc URL for APIs used by the quickstart
      const DISCOVERY_DOC = 'https://www.googleapis.com/discovery/v1/apis/admin/directory_v1/rest';

      // Authorization scopes required by the API; multiple scopes can be
      // included, separated by spaces.
      const SCOPES = 'https://www.googleapis.com/auth/admin.directory.user.readonly';

      let tokenClient;
      let gapiInited = false;
      let gisInited = false;

      document.getElementById('authorize_button').style.visibility = 'hidden';
      document.getElementById('signout_button').style.visibility = 'hidden';

      /**
       * Callback after api.js is loaded.
       */
      function gapiLoaded() {
        gapi.load('client', initializeGapiClient);
      }

      /**
       * Callback after the API client is loaded. Loads the
       * discovery doc to initialize the API.
       */
      async function initializeGapiClient() {
        await gapi.client.init({
          apiKey: API_KEY,
          discoveryDocs: [DISCOVERY_DOC],
        });
        gapiInited = true;
        maybeEnableButtons();
      }

      /**
       * Callback after Google Identity Services are loaded.
       */
      function gisLoaded() {
        tokenClient = google.accounts.oauth2.initTokenClient({
          client_id: CLIENT_ID,
          scope: SCOPES,
          callback: '', // defined later
        });
        gisInited = true;
        maybeEnableButtons();
      }

      /**
       * Enables user interaction after all libraries are loaded.
       */
      function maybeEnableButtons() {
        if (gapiInited && gisInited) {
          document.getElementById('authorize_button').style.visibility = 'visible';
        }
      }

      /**
       *  Sign in the user upon button click.
       */
      function handleAuthClick() {
        tokenClient.callback = async (resp) => {
          if (resp.error !== undefined) {
            throw (resp);
          }
          document.getElementById('signout_button').style.visibility = 'visible';
          document.getElementById('authorize_button').innerText = 'Refresh';
          await listUsers();
        };

        if (gapi.client.getToken() === null) {
          // Prompt the user to select a Google Account and ask for consent to share their data
          // when establishing a new session.
          tokenClient.requestAccessToken({prompt: 'consent'});
        } else {
          // Skip display of account chooser and consent dialog for an existing session.
          tokenClient.requestAccessToken({prompt: ''});
        }
      }

      /**
       *  Sign out the user upon button click.
       */
      function handleSignoutClick() {
        const token = gapi.client.getToken();
        if (token !== null) {
          google.accounts.oauth2.revoke(token.access_token);
          gapi.client.setToken('');
          document.getElementById('content').innerText = '';
          document.getElementById('authorize_button').innerText = 'Authorize';
          document.getElementById('signout_button').style.visibility = 'hidden';
        }
      }

      /**
       * Print the first 10 users in the domain.
       */
      async function listUsers() {
        let response;
        try {
          const request = {
            'customer': 'my_customer',
            'maxResults': 10,
            'orderBy': 'email',
          };
          response = await gapi.client.directory.users.list(request);
        } catch (err) {
          document.getElementById('content').innerText = err.message;
          return;
        }

        const users = response.result.users;
        if (!users || users.length == 0) {
          document.getElementById('content').innerText = 'No users found.';
          return;
        }
        // Flatten to string to display
        const output = users.reduce(
            (str, user) => `${str}${user.primaryEmail} (${user.name.fullName})\n`,
            'Users:\n');
        document.getElementById('content').innerText = output;
      }
    </script>
  </body>
</html>
```

--------------------------------

### HTTP GET Request for Entity Usage Report

Source: https://developers.google.com/workspace/admin/reports/reference/rest/v1/entityUsageReports/get

This example shows a basic GET request to retrieve usage data for a specific entity type and date. It includes path parameters for entity type, entity key, and date.

```http
GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}
```