#Важно

Gemini API постоянно растет и развивается. С выпуском GeminiWithFiles v2.x.x (и последней версии v2.0.30) библиотека претерпела значительные обновления, включая поддержку последней модели Gemini 3.1 Flash Lite, детальное отслеживание использования токенов и Agent Skills (архитектура Progressive Disclosure и Subagent Orchestration).

Если вы хотите использовать наследие GeminiWithFiles v1.x.x, пожалуйста, см. здесь.

#Обзор

GeminiWithFiles - это мощная библиотека сценариев приложений Google (GAS), предназначенная для оптимизации взаимодействия с API Gemini, особенно при работе с файлами и неструктурированными данными.

Используя эту библиотеку, разработчики могут легко загружать файлы (изображения, PDF-файлы, видео и т. д.), генерировать текстовый или структурированный контент JSON, выполнять код, выполнять заземление поиска Google и даже создавать автономные агенты ИИ с использованием навыков агента. Это значительно снижает накладные расходы на кодирование и расширяет возможности интеграции Gemini в рабочее пространство Google.

#Описание

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