# gdrive-access-monitor

> This is a basic tool to enable the easy evaluation of access settings for folders on Google Drive. The code is bundled with [webpack](https://www.npmjs.com/package/webpack) and pushed to the [GDriveAccessMonitorScript](https://script.google.com/home/proje

Latest version **0.1.1** (published 2026-02-24) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install gdrive-access-monitor
pnpm add gdrive-access-monitor
yarn add gdrive-access-monitor
bun add gdrive-access-monitor
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2026-02-24 |
| First published | 2023-01-31 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 28.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | balena.io |

## Links

- npm: https://www.npmjs.com/package/gdrive-access-monitor
- Repository: https://github.com/yourusername/the-repo-name
- Homepage: https://github.com/yourusername/the-repo-name#readme
- Issues: https://github.com/yourusername/the-repo-name/issues
- npm.io page: https://npm.io/package/gdrive-access-monitor

## Dependencies (1)

- [dreamsheets](https://npm.io/package/dreamsheets.md) ^2.0.1

## Recent versions

- 0.1.1 (latest) — 2026-02-24
- 0.1.1-build-add-npm-oidc-permissions-f6eb59f229db14a31536766f11e15de964de442d-4 (build-add-npm-oidc-permissions) — 2026-02-24
- 0.1.0-build-first-operational-version-c24727a88220311597350243c239ad58ae959d64-1 (build-first-operational-version-c24727a88220311597350243c239ad58ae959d64) — 2023-01-31
- 0.1.0 — 2023-01-31

## README

# GDrive Access Monitor
This is a basic tool to enable the easy evaluation of access settings for folders on Google Drive. The code is bundled with [webpack](https://www.npmjs.com/package/webpack) and pushed to the [GDriveAccessMonitorScript](https://script.google.com/home/projects/1dJWdUhaRJUcRZ9Nk1Ac2ZCpDjOAoQKN2CFmZL-JUK4gxToEqO4YgGjfl/edit) Google Apps Script (GAS) project by making use of [google/clasp](https://github.com/google/clasp). This GAS project is connected to the [GDrive Access Monitor](https://docs.google.com/spreadsheets/d/1xcomXsmJHwHMzRVAucsNTlPtEo4fEYvbiHROPnObLFM/edit#gid=0) Google Sheet, from where the script is run and where the resulting access settings are reported.

## Usage

* In the [Folders](https://docs.google.com/spreadsheets/d/1xcomXsmJHwHMzRVAucsNTlPtEo4fEYvbiHROPnObLFM/edit#gid=0) tab, enter the `Name` and `ID` of the folder for which you want to evaluate access. The `Name` can be anything you choose, but the logical choice is usually to make it the same as the actual name of the folder. The `ID` has to be the id of the GDrive folder as contained in its url:

  ```
  https://drive.google.com/drive/folders/<ID>
  ```

* Then, while this row in the sheet is selected, go to the `Custom scripts` menu, and click on `Query access for selected folder`. The script will retrieve the information, and write the results to a sheet called `Name` within this spreadsheet. The query is performed recursively, so that the access settings for all (nested) subfolders and files within the given folder is reported.

**Note:** The person running the script already needs to have access to the folder that they want to evaluate.

## Contributing

Please check out the recommended workflow [here](https://handbook.balena.io/tooling/model-framework#recommended-workflow-for-contributions).

If necessary, this project could be expanded to perform periodic checks of the access settings (potentially comparing with some expected access specification), and/or to perform batch updates of access levels for specific folders.

## Licence

This code is licenced under the Apache License, Version 2.0.

## Built with

- [Google Cloud Platform](https://cloud.google.com/)
- [Node.js](https://nodejs.org/en/download/)
- [google/clasp](https://github.com/google/clasp)
- [dreamsheets-scripts](https://github.com/product-os/dreamsheets-scripts) (see its README for things like customizing the oauth scopes for the project)

---
_Source: https://npm.io/package/gdrive-access-monitor · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._