1. Go to the Integrations page within Ploy

Navigate to the integrations page in the bottom left of Ploy and select the Google Workspace integration.

https://downloads.intercomcdn.com/i/o/907458975/4ed46d2043a04d4ac51d2516/Screenshot+2023-12-12+at+14.53.17.png?expires=1734258600&signature=833099335e96ac71ca1b7ba0a4c56ca5807a7129b52f3185dcb9f003be7ddab5&req=fSAgEsx2lIZaFb4f3HP0gH6aXlyeOx7RR99mCIcOYtK%2BYSU4npt0GoQOx2c3
tLlR4CAf1nB4JmU1cQ%3D%3D

2. Configure your Google Workspace Integration

This is where you can configure the integrations for your integration with Google Workspace:

Scopes required for Google Scanning

Admin.directory.user.readonly Scope for only retrieving users or user aliases. Required
admin.reports.audit.readonly View audit reports for your G Suite domain. Required
admin.directory.user.security Scope for access to all application-specific password, OAuth token, and verification code operations. Required
gmail.readonly Read all resources and their metadata - no write operations. Optional with email scanning enabled

3. Click "Authenticate"

This will prompt you to authenticate your google account.

https://downloads.intercomcdn.com/i/o/lk3zeqoc/1231095060/fc221e9840548ea3efab0b1db835/Screenshot+2024-10-28+at+10_11_57.png?expires=1734258600&signature=747b618018aca4af4678c6ee1b95b7004011a1379146c129dfffb9aae0534923&req=dSIkF8l3mIFZWfMW1HO4zSO1ZdR3WKQCuPZJXNB8janaJZ8rDP665%2BDyNwy0
9QFcv9odkiA%2BegCtvn4%3D

4. Click "Authenticate with Google"

https://downloads.intercomcdn.com/i/o/lk3zeqoc/1231096476/bb08c9978152fd034da15d2312de/Screenshot+2024-10-28+at+10_12_04.png?expires=1734258600&signature=5cfcb5e95b2c0d4e19dbaa3ffa81879698900303fb8c6e9b684437e67d48bb47&req=dSIkF8l3m4VYX%2FMW1HO4zet5GondWSl0au1%2BvDnaL2o3B4mI0ujHkvlw%2BARZ
S%2FIc2ZTXO8u1jDJmw0I%3D

This will take you to your Google Admin console and request domain wide delegation scopes to be added to Google Workspace account based on the config you selected in Step 2

https://downloads.intercomcdn.com/i/o/907459387/f03f56dafcd403d6ad11ef02/Screenshot+2023-12-12+at+14.56.14.png?expires=1734258600&signature=6631f3285a845eb11deecf4025b4846513d191d489e6ab4c2e7dbc4c92cc5bf1&req=fSAgEsx3nolYFb4f3HP0gLQD8gZ%2FZaeo0JffSsuqRaOKvqFo3QinAM%2BhEFXf
d1BezN9DVWE7ze1uWA%3D%3D

5. Click Test and then Save the integration

https://downloads.intercomcdn.com/i/o/907472827/3c08c07f0abbf012fdc273c3/Screenshot+2023-12-12+at+15.10.16.png?expires=1734258600&signature=b0598bddc7a192816e87aecc7c6c9e5fca184a8824e34073ff2cd646bb586710&req=fSAgEs58lYNYFb4f3HP0gKBnvU1GUpcOolfJ%2BsRmyd0OsjL1XZFQHFdObdQl
8UoigWLXp3UVskQSVA%3D%3D