Google Drive Helper is a lightweight, dependency-free utility for interacting with the Google Drive API, making it easy to authenticate users, create and read files (JSON and plain text), and manage folder contents.

🚀 Features

✅ Simple authentication using Google Identity Services.
✅ Create, read, and move files in Google Drive.
✅ Supports JSON and plain text file operations.
✅ List files in a folder.
✅ No dependencies – pure JavaScript.

📦 Installation

To install via npm, run:

npm install mkt-google-drive-utils

🎯 Quick Start

1️⃣ Import the module and initialize it

import drive from "mkt-google-drive-utils";

// Initialize with your CLIENT_ID
drive.init("YOUR_GOOGLE_CLIENT_ID");

2️⃣ Authenticate the user to get the token

Call drive.authenticate() when the user clicks a button. Important: This should be called in a user interactive mode. That is why is better to call in a button click event.

await drive.authenticate();
console.log("User authenticated successfully!");

📁 File Operations

📌 List All Files in a Folder

Retrieve a list of files inside a folder.

const files = await drive.readFolder("FOLDER_ID");

console.log(files);

Each file in the array contains:

[
  { "id": "FILE_ID", "name": "example.json" },
  { "id": "FILE_ID", "name": "notes.txt" }
]

📌 Create a JSON File

Save a JavaScript object as a JSON file inside a Google Drive folder.

const myObject = { theme: "dark", lang: "en" };
await drive.createJsonFile("FOLDER_ID", "settings.json", myObject);

📌 Read a JSON File

Read a JSON file and parse its content.

const settings = await drive.readJsonFile("FOLDER_ID", "settings.json");
console.log(settings); // Output: { theme: "dark", lang: "en" }

You can also read a file by file ID:

const settings = await drive.readJsonFile("FILE_ID");

📌 Create a Plain Text File

Save plain text content inside a Google Drive folder.

await drive.createFile("FOLDER_ID", "notes.txt", "Hello, Google Drive!");

📌 Read a Plain Text File

Retrieve text content from a file.

const content = await drive.readFile("FOLDER_ID", "notes.txt");
console.log(content); // Output: "Hello, Google Drive!"

Alternatively, read by file ID:

const content = await drive.readFile("FILE_ID");

📌 Move a File Between Folders

Move a file from one folder to another.

await drive.moveFile("SOURCE_FOLDER_ID", "notes.txt", "DESTINATION_FOLDER_ID");

📌 Delete Files

Delete.

await drive.deleteFile("SOURCE_FOLDER_ID", "notes.txt");

await drive.deleteFileId("FILE_ID");

🔧 Example HTML Page

You can also check the HTML example from the [example] folder in github.

📝 index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>MK Google Drive Utils Example</title>
    <!-- LINK API -->
    <script src="https://accounts.google.com/gsi/client" async defer></script>
</head>
<body>

    <h1>Google Drive Helper Example</h1>

    <button id="authButton">Authenticate</button>
    <button id="createFile">Create JSON File</button>
    <button id="readFile">Read JSON File</button>
    <button id="listFiles">List Folder Files</button>
    
    <pre id="output"></pre>

    <script type="module" src="app.js"></script>
</body>
</html>

📝 app.js

import { CLIENT_ID, FOLDER_ID } from "./config.js";
import drive from "../src/drive.js"; 

// Initialize
drive.init(CLIENT_ID);


// Authenticate
document.getElementById("authButton").addEventListener("click", async () => {
    await drive.authenticate();
    log("Authentication successful!");
});


// Now perform any action

document.getElementById("createFile").addEventListener("click", async () => {
    await drive.createJsonFile(FOLDER_ID, "example.json", { message: "Hello, world!" });
    log("JSON file created!");
});

document.getElementById("readFile").addEventListener("click", async () => {
    const content = await drive.readJsonFile(FOLDER_ID, "example.json");
    log("Read JSON: " + JSON.stringify(content, null, 2));
});

document.getElementById("listFiles").addEventListener("click", async () => {
    const files = await drive.readFolder(FOLDER_ID);
    log("Files in folder: " + JSON.stringify(files, null, 2));
});

function log(message) {
    document.getElementById("output").textContent = message;
}

📝 config.js

export const CLIENT_ID = "YOUR_GOOGLE_CLIENT_ID";
export const FOLDER_ID = "YOUR_FOLDER_ID";

🔐 Authentication Setup

1️⃣ Go to Google Cloud Console

2️⃣ Create a new project

3️⃣ Enable Google Drive API

4️⃣ Create OAuth 2.0 Credentials (Web Application)

5️⃣ Set "Authorized JavaScript Origins" eg. http://localhost:8080

6️⃣ Copy your CLIENT_ID and paste it into your code.

📜 License

This project is licensed under the MIT License.

🔗 Links

📦 npm package: https://www.npmjs.com/package/mkt-google-drive-utils

💻 GitHub Repo: https://github.com/cristianmercado19/google-drive-utils

📖 Google Drive API Docs: https://developers.google.com/drive

🚀 Contributing

Pull requests are welcome! If you’d like to improve the library, please open an issue first to discuss changes.

Keywords

FAQs

What is mkt-google-drive-utils?

Is mkt-google-drive-utils popular?

Is mkt-google-drive-utils well maintained?

Package last updated on 28 Feb 2025

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

mkt-google-drive-utils