중요

Gemini API는 지속적으로 성장하고 진화합니다. GeminiWithFiles v2.x.x (과 최신 v2.0.30)의 릴리스를 통해 라이브러리는 최신 Gemini 3.1 Flash Lite 모델, 상세한 토큰 사용 추적 및 Agent Skills (Progressive Disclosure Architecture and Subagent Orchestration)에 대한 지원을 포함하여 주요 업데이트를 받았습니다.

레거시 GeminiWithFiles v1.x.x를 사용하려면 여기를 클릭하십시오.

개요

GeminiWithFiles는 파일과 구조화되지 않은 데이터로 작업할 때 Gemini API와의 상호 작용을 간소화하도록 설계된 강력한 Google Apps Script (GAS) 라이브러리입니다.

이 라이브러리를 사용하여 개발자는 쉽게 파일을 업로드 할 수 있습니다 (이미지, PDF, 비디오 등), 텍스트 또는 구조화 된 JSON 콘텐츠를 생성하고 코드를 실행하고 Google 검색 접지를 수행하고 Agent Skills를 사용하여 자율 AI 에이전트를 구축 할 수 있습니다. 이 두드러지게 코딩 오버 헤드를 감소시키고 Gemini를 Google Workspace로 통합하는 가능성을 확장합니다.

묘사

GeminiWithFiles

IMPORTANT

Gemini API is continually growing and evolving. With the release of GeminiWithFiles v2.x.x (and the latest v2.0.30), the library has undergone major updates, including support for the latest Gemini 3.1 Flash Lite model, detailed token usage tracking, and Agent Skills (Progressive Disclosure architecture and Subagent Orchestration).

If you want to use the legacy GeminiWithFiles v1.x.x, please see here.

Overview

GeminiWithFiles is a powerful Google Apps Script (GAS) library designed to streamline interactions with the Gemini API, particularly when working with files and unstructured data.

By utilizing this library, developers can effortlessly upload files (images, PDFs, videos, etc.), generate text or structured JSON content, execute code, perform Google Search grounding, and even build autonomous AI agents using Agent Skills. This significantly reduces coding overhead and expands the possibilities of integrating Gemini into Google Workspace.

Description

As large language models (LLMs) continue to advance, Google’s Gemini models have opened up unprecedented possibilities for converting unstructured data (like images, videos, and PDFs) into structured, actionable insights.

With the latest Gemini 3.1 capabilities, the context window and multimodal processing power have reached new heights. You can now analyze massive documents, batch-process images, and natively interpret PDF data directly without third-party conversions. Ref Ref

While Gemini does not natively parse Google Workspace proprietary formats (Docs, Sheets, Slides) directly, we can use workarounds like converting them to PDF and leveraging the Gemini API’s direct PDF input features.

GeminiWithFiles abstracts away the complexities of making direct REST API calls from Apps Script. It handles the nuances of multipart uploads, resumable uploads for large files (>50MB), token counting, and multi-turn chat context. More importantly, the latest version introduces Agent Skills, allowing developers to create dynamic, autonomous agent workflows where the model decides which tools to use, reads configurations from Google Drive, dynamically executes JavaScript in your GAS environment, and even delegates tasks to specialized subagents. Ref