Home

PSGoogle

Powershell module wrapping Google Apps API calls in handy functions. Authentication is established using a service account via P12 key to negate the consent popup and allow for greater handsoff automation capabilities

Prerequisites

In order to use this module, you'll need to have the following:

• Service Account Key created and downloaded as a P12 key file.
• API Client access allowed for the Service Account that will be used towards the API scopes that you intend to utilize
• Domain-Wide Delegation enabled for the service account

Tips & Tricks

• All functions support pre-acquired Access Tokens (using the AccessToken parameter).
  • This is useful if you have a lot of recurring commands that leverage the same admin and scope(s) so you do not overrun the user API call quota, i.e. pulling info for a large set of emails in a user's inbox.
  • If the access token is not pre-acquired, then the P12KeyPath, AppEmail, AdminEmail, CustomerID, and Domain parameters will default to reading from the PSGoogle config file (these can also be named in each function call, if preferred).

Credits

Handling the Service Account OAuth procedure in Powershell:

• http://www.thingsthatmademeangry.com/2014/11/google-apps-oauth2-service-account.html

Initial expoloration into Google Apps management via command line:

• https://github.com/jay0lee/GAM (thank you for all of your help along the way Jay & Ross!)