Эта страница переведена с помощью Cloud Translation API.

Анализируйте и маркируйте сообщения Gmail с помощью Gemini и Vertex AI

Это решение использует Vertex AI и Gemini для анализа сообщений Gmail и маркировки их на основе их тональности.

Уровень кодирования : средний
Продолжительность : 30 минут
Тип проекта : дополнение к Google Workspace

Рисунок 1: Дополнение «Анализ настроений» отображает боковую панель в Gmail, где пользователи могут подсказать Gemini проанализировать сообщения и применить к ним метки на основе их настроений.
Рисунок 2: Дополнение помечает сообщение Gmail меткой НЕЙТРАЛЬНЫЙ ТОН 😐 .
Рисунок 3: Дополнение помечает сообщение Gmail меткой СЧАСТЛИВЫЙ ТОН 😊 .
Рисунок 4: Дополнение помечает сообщение Gmail меткой РАССТРОЕННЫЙ ТОН 😡 .

Цели

Поймите, что делает решение.
Понять, какие функции выполняют службы Google в рамках решения.
Настройте окружающую среду.
Настройте проект Google Apps Script.
Запустите скрипт.

Об этом решении

Скриншот дополнения «Анализ настроений» Google Workspace

Это решение представляет собой надстройку Google Workspace, которая применяет метки на основе тональности сообщений Gmail. Для анализа содержимого сообщений надстройка использует Vertex AI, чтобы запросить у модели Gemini 2.5 Flash один из следующих вариантов тональности:

Положительный
Отрицательно
Нейтральный

Получив ответ от Gemini, дополнение применяет к сообщению соответствующую метку Gmail.

Чтобы ограничить количество запросов к API Vertex AI, это дополнение анализирует и применяет метки только к 10 последним сообщениям в почтовом ящике пользователя Gmail. Подробнее о квотах и ограничениях см. в документации Vertex AI .

Как это работает

Это решение построено на Google Apps Script и использует следующие сервисы и продукты Google:

Vertex AI API – предлагает модели Gemini 2.5 Flash анализировать содержимое сообщений Gmail и определять их тональность.
Службы скриптов приложений:
- Служба Gmail — извлекает и применяет метки к сообщениям Gmail. При необходимости создаёт образцы сообщений для тестирования дополнения.
- Служба карт – создает пользовательский интерфейс дополнения, которое отображается в виде боковой панели в Gmail.
- Служба Url Fetch – подключается к API Vertex AI для анализа настроений.
- Служба скриптов — для вызова API Vertex AI получает токен доступа OAuth 2.0 для надстройки с помощью метода getOAuthToken .
Внимание: вызов API Vertex AI с помощью метода getOAuthToken предназначен только для примера. Для использования этого дополнения вне личных целей рекомендуется использовать аутентификацию с помощью учётной записи службы .

Предпосылки

Проект Google Cloud с включённым биллингом. Чтобы узнать, есть ли у вас доступ, см. раздел «Разрешения, необходимые для включения биллинга» .

Настройте свою среду

В этом разделе объясняется, как настроить и обработать вашу среду в консоли Google Cloud и Apps Script.

Настройте свой облачный проект в консоли Google Cloud

В этом разделе показано, как включить API Vertex AI и настроить экран согласия OAuth в вашем облачном проекте.

Включить API Vertex AI

В консоли Google Cloud откройте свой проект Google Cloud и включите API Vertex AI:
Включить API
Подтвердите, что вы включаете API в правильном облачном проекте, затем нажмите Далее .
Подтвердите, что вы включаете правильный API, затем нажмите Включить .

Настройте экран согласия OAuth

Для дополнений Google Workspace требуется настройка экрана согласия. Настройка экрана согласия OAuth для вашего дополнения определяет, что Google будет показывать пользователям.

В консоли Google Cloud перейдите в > > Брендинг .
Перейти к брендингу
Если вы уже настроили , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение: пока не настроено , нажмите «Начать» :

В разделе «Информация о приложении» в поле «Имя приложения » введите имя приложения.
В поле Адрес электронной почты службы поддержки пользователей выберите адрес электронной почты службы поддержки, по которому пользователи смогут связаться с вами, если у них возникнут вопросы относительно их согласия.
Нажмите кнопку «Далее» .
В разделе Аудитория выберите Внутренняя .
Нажмите кнопку «Далее» .
В разделе «Контактная информация» введите адрес электронной почты , на который вы можете получать уведомления о любых изменениях в вашем проекте.
Нажмите кнопку «Далее» .
В разделе Готово ознакомьтесь с Политикой обработки данных пользователей API служб Google и, если вы согласны, выберите Я согласен с Политикой обработки данных пользователей API служб Google .
Нажмите «Продолжить» .
Нажмите «Создать» .

На данный момент вы можете пропустить добавление областей действия. В будущем при создании приложения для использования за пределами вашей организации Google Workspace необходимо изменить тип пользователя на «Внешний» . Затем добавьте области действия авторизации, необходимые вашему приложению. Подробнее см. в полном руководстве по настройке согласия OAuth .

Создайте и настройте свой проект Apps Script

Чтобы создать и настроить проект Apps Script для надстройки, выполните следующие действия:

Нажмите следующую кнопку, чтобы открыть проект скрипта анализа настроений в Gmail с помощью приложений Gemini и Vertex AI .
Откройте проект Apps Script.
Нажмите Обзор .
На странице обзора нажмите «Сделать копию». .
Получите номер вашего облачного проекта:
1. В консоли Google Cloud перейдите в > IAM и администрирование > Настройки .
  Перейти к настройкам IAM и администрирования
2. В поле Номер проекта скопируйте значение.
Подключите свой проект Cloud к проекту Apps Script:
1. В скопированном проекте Apps Script нажмите «Настройки проекта» . .
2. В разделе «Проект Google Cloud Platform (GCP)» нажмите «Изменить проект» .
3. В поле Номер проекта GCP вставьте номер облачного проекта.
4. Нажмите Установить проект .

Протестируйте дополнение

Чтобы опробовать дополнение, установите тестовое развертывание, а затем откройте дополнение в Gmail:

Создайте и установите тестовое развертывание Apps Script:
1. В скопированном проекте Apps Script нажмите Editor .
2. Откройте файл Code.gs и нажмите «Выполнить» . При появлении запроса авторизуйте скрипт.
3. Нажмите Развернуть > Тестовые развертывания .
4. Нажмите Установить > Готово .
Откройте Gmail.
Перейти в Gmail
На правой боковой панели откройте дополнение Sentiment Analysis .
При появлении соответствующего запроса разрешите установку надстройки.
Необязательно: чтобы создать сообщения для тестирования работы вашего дополнения, нажмите «Создать примеры писем» . В вашем почтовом ящике появятся три сообщения. Если вы их не видите, обновите страницу.
Чтобы добавить метки, нажмите «Анализ писем» .

Дополнение просматривает последние 10 сообщений в вашем почтовом ящике, а затем применяет одну из следующих меток в зависимости от содержания сообщения:

СЧАСТЛИВЫЙ ТОН 😊
НЕЙТРАЛЬНЫЙ ТОН 😐
РАССТРОЕННЫЙ ТОН 😡

Проверьте код

Ознакомьтесь с кодом скрипта приложений для этого решения:

Посмотреть исходный код

Код.gs

gmail-sentiment-analysis/Code.gs

Посмотреть на GitHub

/*
Copyright 2024 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Triggered when the add-on is opened from the Gmail homepage.
 *
 * @param {Object} e - The event object.
 * @returns {Card} - The homepage card.
 */
function onHomepageTrigger(e) {
  return buildHomepageCard();
}

Карты.gs

gmail-sentiment-analysis/Cards.gs

Посмотреть на GitHub

/*
Copyright 2024-2025 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Builds the main card displayed on the Gmail homepage.
 *
 * @returns {Card} - The homepage card.
 */
function buildHomepageCard() {
  // Create a new card builder
  const cardBuilder = CardService.newCardBuilder();

  // Create a card header
  const cardHeader = CardService.newCardHeader();
  cardHeader.setImageUrl('https://fonts.gstatic.com/s/i/googlematerialicons/mail/v6/black-24dp/1x/gm_mail_black_24dp.png');
  cardHeader.setImageStyle(CardService.ImageStyle.CIRCLE);
  cardHeader.setTitle("Analyze your Gmail");

  // Add the header to the card
  cardBuilder.setHeader(cardHeader);

  // Create a card section
  const cardSection = CardService.newCardSection();

  // Create buttons for generating sample emails and analyzing sentiment
  const buttonSet = CardService.newButtonSet();

  // Create "Generate sample emails" button
  const generateButton = createFilledButton('Generate sample emails', 'generateSampleEmails', '#34A853');
  buttonSet.addButton(generateButton);

  // Create "Analyze emails" button
  const analyzeButton = createFilledButton('Analyze emails', 'analyzeSentiment', '#FF0000');
  buttonSet.addButton(analyzeButton);

  // Add the button set to the section
  cardSection.addWidget(buttonSet);

  // Add the section to the card
  cardBuilder.addSection(cardSection);

  // Build and return the card
  return cardBuilder.build();
}

/**
 * Creates a filled text button with the specified text, function, and color.
 *
 * @param {string} text - The text to display on the button.
 * @param {string} functionName - The name of the function to call when the button is clicked.
 * @param {string} color - The background color of the button.
 * @returns {TextButton} - The created text button.
 */
function createFilledButton(text, functionName, color) {
  // Create a new text button
  const textButton = CardService.newTextButton();

  // Set the button text
  textButton.setText(text);

  // Set the action to perform when the button is clicked
  const action = CardService.newAction();
  action.setFunctionName(functionName);
  textButton.setOnClickAction(action);

  // Set the button style to filled
  textButton.setTextButtonStyle(CardService.TextButtonStyle.FILLED);

  // Set the background color
  textButton.setBackgroundColor(color);

  return textButton;
}

/**
 * Creates a notification response with the specified text.
 *
 * @param {string} notificationText - The text to display in the notification.
 * @returns {ActionResponse} - The created action response.
 */
function buildNotificationResponse(notificationText) {
  // Create a new notification
  const notification = CardService.newNotification();
  notification.setText(notificationText);

  // Create a new action response builder
  const actionResponseBuilder = CardService.newActionResponseBuilder();

  // Set the notification for the action response
  actionResponseBuilder.setNotification(notification);

  // Build and return the action response
  return actionResponseBuilder.build();
}

Gmail.gs

gmail-sentiment-analysis/Gmail.gs

Посмотреть на GitHub

/*
Copyright 2024-2025 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Analyzes the sentiment of the first 10 threads in the inbox
 * and labels them accordingly.
 *
 * @returns {ActionResponse} - A notification confirming completion.
 */
function analyzeSentiment() {
  // Analyze and label emails
  analyzeAndLabelEmailSentiment();

  // Return a notification
  return buildNotificationResponse("Successfully completed sentiment analysis");
}

/**
 * Analyzes the sentiment of emails and applies appropriate labels.
 */
function analyzeAndLabelEmailSentiment() {
  // Define label names
  const labelNames = ["HAPPY TONE 😊", "NEUTRAL TONE 😐", "UPSET TONE 😡"];

  // Get or create labels for each sentiment
  const positiveLabel = GmailApp.getUserLabelByName(labelNames[0]) || GmailApp.createLabel(labelNames[0]);
  const neutralLabel = GmailApp.getUserLabelByName(labelNames[1]) || GmailApp.createLabel(labelNames[1]);
  const negativeLabel = GmailApp.getUserLabelByName(labelNames[2]) || GmailApp.createLabel(labelNames[2]);

  // Get the first 10 threads in the inbox
  const threads = GmailApp.getInboxThreads(0, 10);

  // Iterate through each thread
  for (const thread of threads) {
    // Iterate through each message in the thread
    const messages = thread.getMessages();
    for (const message of messages) {
      // Get the plain text body of the message
      const emailBody = message.getPlainBody();

      // Analyze the sentiment of the email body
      const sentiment = processSentiment(emailBody);

      // Apply the appropriate label based on the sentiment
      if (sentiment === 'positive') {
        thread.addLabel(positiveLabel);
      } else if (sentiment === 'neutral') {
        thread.addLabel(neutralLabel);
      } else if (sentiment === 'negative') {
        thread.addLabel(negativeLabel);
      }
    }
  }
}

/**
 * Generates sample emails for testing the sentiment analysis.
 *
 * @returns {ActionResponse} - A notification confirming email generation.
 */
function generateSampleEmails() {
  // Get the current user's email address
  const userEmail = Session.getActiveUser().getEmail();

  // Define sample emails
  const sampleEmails = [
    {
      subject: 'Thank you for amazing service!',
      body: 'Hi, I really enjoyed working with you. Thank you again!',
      name: 'Customer A'
    },
    {
      subject: 'Request for information',
      body: 'Hello, I need more information on your recent product launch. Thank you.',
      name: 'Customer B'
    },
    {
      subject: 'Complaint!',
      body: '',
      htmlBody: `<p>Hello, You are late in delivery, again.</p>
<p>Please contact me ASAP before I cancel our subscription.</p>`,
      name: 'Customer C'
    }
  ];

  // Send each sample email
  for (const email of sampleEmails) {
    GmailApp.sendEmail(userEmail, email.subject, email.body, {
      name: email.name,
      htmlBody: email.htmlBody
    });
  }

  // Return a notification
  return buildNotificationResponse("Successfully generated sample emails");
}

Vertex.gs

gmail-sentiment-analysis/Vertex.gs

Посмотреть на GitHub

/*
Copyright 2024-2025 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

// Replace with your project ID
const PROJECT_ID = '[ADD YOUR GCP PROJECT ID HERE]';

// Location for your Vertex AI model
const VERTEX_AI_LOCATION = 'us-central1';

// Model ID to use for sentiment analysis
const MODEL_ID = 'gemini-2.5-flash';

/**
 * Sends the email text to Vertex AI for sentiment analysis.
 *
 * @param {string} emailText - The text of the email to analyze.
 * @returns {string} - The sentiment of the email ('positive', 'negative', or 'neutral').
 */
function processSentiment(emailText) {
  // Construct the API endpoint URL
  const apiUrl = `https://${VERTEX_AI_LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION}/publishers/google/models/${MODEL_ID}:generateContent`;

  // Prepare the request payload
  const payload = {
    contents: [
      {
        role: "user",
        parts: [
          {
            text: `Analyze the sentiment of the following message: ${emailText}`
          }
        ]
      }
    ],
    generationConfig: {
      temperature: 0.9,
      maxOutputTokens: 1024,
      responseMimeType: "application/json",
      // Expected response format for simpler parsing.
      responseSchema: {
        type: "object",
        properties: {
          response: {
            type: "string",
            enum: ["positive", "negative", "neutral"]
          }
        }
      }
    }
  };

  // Prepare the request options
  const options = {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${ScriptApp.getOAuthToken()}`
    },
    contentType: 'application/json',
    muteHttpExceptions: true, // Set to true to inspect the error response
    payload: JSON.stringify(payload)
  };

  // Make the API request
  const response = UrlFetchApp.fetch(apiUrl, options);

  // Parse the response. There are two levels of JSON responses to parse.
  const parsedResponse = JSON.parse(response.getContentText());
  const sentimentResponse = JSON.parse(parsedResponse.candidates[0].content.parts[0].text).response;

  // Return the sentiment
  return sentimentResponse;
}

appsscript.json

gmail-sentiment-analysis/appsscript.json

Посмотреть на GitHub

{
  "timeZone": "America/Toronto",
  "oauthScopes": [
    "https://www.googleapis.com/auth/cloud-platform",
    "https://www.googleapis.com/auth/gmail.addons.execute",
    "https://www.googleapis.com/auth/gmail.labels",
    "https://www.googleapis.com/auth/gmail.modify",
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/userinfo.email"
  ],
  "addOns": {
    "common": {
      "name": "Sentiment Analysis",
      "logoUrl": "https://fonts.gstatic.com/s/i/googlematerialicons/sentiment_extremely_dissatisfied/v6/black-24dp/1x/gm_sentiment_extremely_dissatisfied_black_24dp.png"
    },
    "gmail": {
      "homepageTrigger": {
        "runFunction": "onHomepageTrigger",
        "enabled": true
      }
    }
  },
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

Уборка

Чтобы избежать списания средств с вашего аккаунта Google Cloud за ресурсы, используемые в этом руководстве, мы рекомендуем вам удалить проект Cloud.

Внимание: удаление проекта имеет следующие последствия:

Всё в проекте будет удалено. Если для этого руководства вы использовали существующий проект, при его удалении будет удалена и вся остальная работа, проделанная вами в этом проекте.
Пользовательские идентификаторы проектов утеряны. При создании этого проекта вы могли создать собственный идентификатор проекта, который захотите использовать в будущем. Чтобы сохранить URL-адреса, использующие этот идентификатор проекта, например URL-адрес на appspot.com, удалите выбранные ресурсы внутри проекта, а не весь проект.

Если вы планируете изучить несколько учебных пособий и кратких руководств, повторное использование проектов может помочь вам избежать превышения квот проекта.

В консоли Google Cloud перейдите на страницу «Управление ресурсами» . Выберите « Меню > «IAM и администрирование» > «Управление ресурсами» .
Перейти к диспетчеру ресурсов
В списке проектов выберите проект .
В диалоговом окне введите идентификатор проекта, а затем нажмите кнопку «Завершить» , чтобы удалить проект.

Цели

Об этом решении

Как это работает

Предпосылки

Настройте свою среду

Настройте свой облачный проект в консоли Google Cloud

Включить API Vertex AI

Настройте экран согласия OAuth

Создайте и настройте свой проект Apps Script

Протестируйте дополнение

Проверьте код

Посмотреть исходный код

Код.gs

Карты.gs

Gmail.gs

Vertex.gs

appsscript.json

Уборка

Следующие шаги