# Changes to Specific Files — Google Drive

> Watches for changes to specific files, emitting an event when a change is made to one of those files. To watch for changes to shared drive files, use the Changes to Specific Files (Shared Drive) source instead.

- Key: `google_drive-changes-to-specific-files`
- Type: Trigger (Polling)
- Version: 0.3.11
- App: Google Drive (`google_drive`) — https://pipedream.com/apps/google-drive.md
- This page (HTML): https://pipedream.com/apps/google-drive/triggers/changes-to-specific-files
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/google_drive/sources/changes-to-specific-files/changes-to-specific-files.mjs

## Description

Watches for changes to specific files, emitting an event when a change is made to one of those files. To watch for changes to [shared drive](https://support.google.com/a/users/answer/9310351) files, use the **Changes to Specific Files (Shared Drive)** source instead.

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `drive` | `string` | No | Defaults to My Drive. To use a Shared Drive, use the Changes to Specific Files (Shared Drive) source instead. |
| `timer` | `$.interface.timer` | Yes | The Google Drive API requires occasional renewal of push notification subscriptions. This runs in the background, so you should not need to modify this schedule. |
| `changesPageSize` | `integer` | No | Maximum number of changes to fetch per API call (1-1000). Lower values reduce memory usage and the risk of execution timeouts or out-of-memory errors on active drives. |
| `files` | `string[]` | Yes | The files you want to watch for changes. Options are loaded from the connected account. |
| `includeLink` | `boolean` | No | Upload file to your File Stash and emit temporary download link to the file. Google Workspace documents will be converted to PDF. See the docs to learn more about working with files in Pipedream. |
| `dir` | `dir` | No | Dir |
| `perFileInterval` | `integer` | No | How many minutes to wait until the same file can emit another event. If set to 0, this interval is disabled and all events will be emitted. |
| `updateTypes` | `string[]` | Yes | The types of updates you want to watch for on these files. See Google's docs. |

## Returns

Events emitted by Google Drive.

## Run it

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "google_drive-changes-to-specific-files",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_drive: { authProvisionId: "apn_xxxxxxx" },
    drive: "Drive",
    timer: { "intervalSeconds": 900 },
  },
  webhookUrl: "https://example.com/webhooks/google-drive",
})

console.log(deployed.id)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "google_drive-changes-to-specific-files",
    "webhook_url": "https://example.com/webhooks/google-drive",
    "configured_props": {
      "google_drive": { "authProvisionId": "apn_xxxxxxx" },
      "drive": "Drive",
      "timer": { "intervalSeconds": 900 }
    }
  }'
```

**MCP**

MCP servers expose Google Drive actions as on-demand tools.

Changes to Specific Files is an event source, so your application deploys it with the Connect SDK or API and then either receives each event at a webhook URL or retrieves events on demand with the trigger events API.

## Event delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source. Or: no webhook required — your app or agent can fetch recent events from the [trigger events API](https://pipedream.com/docs/connect/api-reference/list-trigger-events.md) instead.

---

- App: https://pipedream.com/apps/google-drive.md · All apps: https://pipedream.com/apps