> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google

The Google integration enables seamless connectivity between allGood and Google Workspace services including Gmail, Google Drive, Google Calendar, and other Google applications. This integration streamlines your workflow by automatically syncing data and enabling two-way communication between platforms.

Leverage the power of Google's ecosystem within allGood to enhance productivity, automate routine tasks, and maintain consistent data across your organization's tools.

## Prerequisites

Before setting up the Google integration with Mary, ensure you have:

* **Google Workspace account** with admin permissions to create service accounts
* **IT department coordination** for creating dedicated Google accounts
* **allGood account** with integration permissions

## IT Coordination Guide

### Security & Account Setup Requirements

* Create a dedicated Google Workspace account for Mary (e.g., [mary-allgood-yourcompany@yourcompany.com](mailto:mary-allgood-yourcompany@yourcompany.com))
* Configure appropriate Google Workspace services (Drive, Docs, Sheets)
* Set up folder structure with proper sharing permissions
* Mary account needs at least "Viewer" access to files for integration use

## Step-by-Step Setup

<Steps>
  <Step title="Create Dedicated Mary Google Account">
    1. **Work with your IT department** to create a new Google Workspace account
    2. **Account format**: [mary-allgood-yourcompany@yourcompany.com](mailto:mary-allgood-yourcompany@yourcompany.com)
    3. **Configure services**: Enable Google Drive, Docs, and Sheets access
    4. **Set security settings** according to company policy
  </Step>

  <Step title="Set Up Folder Structure">
    1. **Create main folder** in Google Drive called "allGood"
    2. **Create subfolders** for organization:

    <Tree>
      <Tree.Folder name="allGood" defaultOpen>
        <Tree.Folder name="Projects" defaultOpen>
          <Tree.Folder name="Project A" />

          <Tree.Folder name="Project B" />

          <Tree.Folder name="Project C" />
        </Tree.Folder>

        <Tree.Folder name="Briefing Docs" />

        <Tree.Folder name="Templates" />

        <Tree.Folder name="Shared Resources" />
      </Tree.Folder>
    </Tree>
  </Step>

  <Step title="Configure Folder Permissions">
    1. **Right-click** the "allGood" folder
    2. Click **Share**
    3. **Add the Mary account** email address
    4. **Set permissions** to "Editor" access
    5. **Check "Notify people"**
    6. **Important**: Check "Make available to people with access"

    <Frame caption="Google Drive sharing dialog with Mary account and Editor permissions">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/google/google_drive_sharing.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=75c31009bf26e074dfb1652f253517c2" alt="Google Drive sharing dialog with Mary account and Editor permissions" width="513" height="547" data-path="images/integrations/google/google_drive_sharing.png" />
    </Frame>
  </Step>

  <Step title="Connect Integration in allGood">
    1. **Log into allGood** and navigate to **Settings** → **Integrations**
    2. Click **Add Integration** and select **Google**
    3. Click **Connect Google Account**
    4. Sign in using the **dedicated Mary Google account** credentials
    5. **Review and accept** the required access scope permissions
    6. Verify the integration shows as **Active** on your integrations page

    <Frame caption="allGood integrations page with Google marked as Active">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/google/google_active.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=d64939f5789acbc2bfbd682ffc0c0028" alt="allGood integrations page with Google marked as Active" width="587" height="65" data-path="images/integrations/google/google_active.png" />
    </Frame>
  </Step>
</Steps>

## Verification & Testing

If Google shows "Active" status in allGood integrations, Mary was able to connect successfully.

Ask Mary to retrieve content from a Google Doc in your shared folder to confirm the integration is working properly.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What Google services are supported?">
    The integration supports Gmail, Google Drive, Google Calendar, Google Sheets, and other Google Workspace services.
  </Accordion>

  <Accordion title="Do I need a Google Workspace account?">
    While a Google Workspace account is recommended for full functionality, many features work with regular Google accounts.
  </Accordion>

  <Accordion title="How do I authenticate with Google services?">
    The integration uses OAuth 2.0 authentication. You'll need to authorize allGood to access your Google services during setup.
  </Accordion>

  <Accordion title="Can I limit which Google services are accessed?">
    Yes, you can configure specific scopes and permissions to limit access to only the Google services you want to integrate.
  </Accordion>

  <Accordion title="How is my data stored and secured?">
    All data is encrypted in transit and at rest. We follow Google's security best practices and maintain SOC 2 compliance.
  </Accordion>

  <Accordion title="What are the API rate limits?">
    Google imposes various rate limits on their APIs. The integration includes intelligent rate limiting to ensure smooth operation.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Why am I getting authentication errors?">
    Common causes include:

    * Expired OAuth tokens
    * Changed Google account passwords
    * Insufficient permissions
    * API access restrictions
  </Accordion>

  <Accordion title="How do I resolve sync issues?">
    Check your internet connection, verify API quotas, review error logs, and ensure proper permissions are configured.
  </Accordion>

  <Accordion title="Where can I get help?">
    * Review this page for setup steps and common issues
    * Contact our support team for technical assistance
  </Accordion>
</AccordionGroup>