Analizowanie nastawienia w opiniach za pomocą interfejsu Google Cloud Natural Language API

Poziom kodowania: średnio zaawansowany
Czas trwania: 20 minut
Typ projektu: automatyzacja z menu niestandardowym

Cele

Dowiedz się, co robi rozwiązanie.
Dowiedz się, jakie funkcje pełnią usługi Apps Script w rozwiązaniu.
skonfigurować środowisko,
Skonfiguruj skrypt.
Uruchom skrypt.

Informacje o rozwiązaniu

Możesz analizować na dużą skalę dane tekstowe, takie jak opinie wyrażane w odpowiedzi na pytania otwarte. Aby przeprowadzić analizę jednostek i analizę nastawienia w Arkuszach Google, to rozwiązanie korzysta z usługi UrlFetch, która łączy się z interfejsem Google Cloud Natural Language API.

ilustracja przedstawiająca działanie analizy nastawienia,

Jak to działa

Skrypt pobiera tekst z arkusza kalkulacyjnego i łączy się z interfejsem Google Cloud Natural Language API, aby analizować encje i nastawienie w ciągu znaków. Tabela przestawna podsumowuje średni wynik nastawienia dla każdej encji wymienionej we wszystkich wierszach danych tekstowych.

Usługi Apps Script

To rozwiązanie korzysta z tych usług:

Usługa arkusza kalkulacyjnego: wysyła dane tekstowe do interfejsu Google Cloud Natural Language API i oznacza każdy wiersz jako „Ukończony” po przeanalizowaniu nastawienia.
Usługa UrlFetch: łączy się z interfejsem Google Cloud Natural Language API, aby przeprowadzić analizę tekstu pod kątem encji i nastawienia.

Wymagania wstępne

Aby użyć tego przykładu, musisz spełnić te wymagania wstępne:

Konto Google (w przypadku kont Google Workspace może być wymagana zgoda administratora).
przeglądarkę internetową z dostępem do internetu,
Projekt Google Cloud z powiązanym kontem rozliczeniowym. Zobacz Włączanie płatności za projekt.

Konfigurowanie środowiska

Aby skorzystać z tego rozwiązania, wykonaj te czynności konfiguracyjne.

Otwórz projekt w chmurze w konsoli Google Cloud.

Otwórz projekt w chmurze, którego chcesz użyć w tym przykładzie:

W konsoli Google Cloud otwórz stronę Wybierz projekt.
Wybierz projekt w chmurze
Wybierz projekt w chmurze Google, którego chcesz używać. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli utworzysz projekt Google Cloud, może być konieczne włączenie płatności za ten projekt.

Włączanie interfejsu Google Cloud Natural Language API

To rozwiązanie łączy się z interfejsem Google Cloud Natural Language API. Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

Włącz interfejs Google Cloud Natural Language API w projekcie w chmurze.

Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

To rozwiązanie wymaga projektu w chmurze ze skonfigurowanym ekranem zgody. Skonfigurowanie ekranu zgody OAuth określa, co Google wyświetla użytkownikom, i rejestruje aplikację, aby można było ją później opublikować.

W konsoli Google Cloud otwórz Menu > Google Auth platform > Branding.
Otwórz Elementy marki
Jeśli masz już skonfigurowany Google Auth platform, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Google Auth platform Jeszcze nie skonfigurowano, kliknij Rozpocznij:

W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, pod którym użytkownicy mogą się z Tobą kontaktować, jeśli mają pytania dotyczące ich zgody.
Kliknij Dalej.
W sekcji Odbiorcy wybierz Wewnętrzny.
Kliknij Dalej.
W sekcji Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o wszelkich zmianach w projekcie.
Kliknij Dalej.
W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google, a jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
Kliknij Dalej.
Kliknij Utwórz.

Na razie możesz pominąć dodawanie zakresów. W przyszłości, gdy będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.

Uzyskiwanie klucza interfejsu Google Cloud Natural Language API

Otwórz konsolę Google Cloud. Sprawdź, czy otwarty jest projekt, w którym włączone są płatności.
W konsoli Google Cloud kliknij Menu > Interfejsy API i usługi > Dane logowania.

Przejdź do danych logowania
Kliknij Utwórz dane logowania > Klucz interfejsu API.
Zapisz klucz interfejsu API, ponieważ będzie potrzebny w dalszym kroku.

Konfigurowanie skryptu

Aby skonfigurować skrypt, wykonaj te czynności:

Tworzenie projektu Apps Script

Kliknij poniższy przycisk, aby utworzyć kopię przykładowego arkusza kalkulacyjnego Analiza nastawienia w przypadku opinii. Projekt Apps Script dla tego rozwiązania jest dołączony do arkusza kalkulacyjnego.

Utwórz kopię
Kliknij Rozszerzenia > Apps Script.
Zastąp w pliku skryptu tę zmienną swoim kluczem interfejsu API:
```
const myApiKey = 'YOUR_API_KEY'; // Replace with your API key.
```
Kliknij Zapisz .

Dodawanie danych tekstowych

Wróć do arkusza kalkulacyjnego.
Dodaj dane tekstowe do kolumn id i comments. Możesz użyć przykładowych opinii o obiektach wakacyjnych z Kaggle lub własnych danych. W razie potrzeby możesz dodać więcej kolumn, ale aby skrypt działał prawidłowo, musi zawierać dane w kolumnach id i comments.

Uruchamianie skryptu

U góry arkusza kalkulacyjnego kliknij Narzędzia do analizy sentymentu > Oznaczanie podmiotów i sentymentu. Aby to menu niestandardowe się pojawiło, konieczne może być odświeżenie strony.
Gdy pojawi się odpowiedni komunikat, autoryzuj skrypt. <<../_snippets/oauth.md>>
Kliknij Narzędzia do analizy sentymentu > ponownie Oznaczanie podmiotów i sentymentu.
Po zakończeniu działania skryptu przejdź do arkusza Tabela przestawna, aby zobaczyć wyniki.

Sprawdź kod

Aby sprawdzić kod Apps Script tego rozwiązania, kliknij Wyświetl kod źródłowy:

Pokaż kod źródłowy

Code.gs

solutions/automations/feedback-sentiment-analysis/code.js

Wyświetl w GitHubie

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/feedback-sentiment-analysis

/*
Copyright 2022 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.
*/

// Sets API key for accessing Cloud Natural Language API.
const myApiKey = "YOUR_API_KEY"; // Replace with your API key.

// Matches column names in Review Data sheet to variables.
const COLUMN_NAME = {
  COMMENTS: "comments",
  ENTITY: "entity_sentiment",
  ID: "id",
};

/**
 * Creates a Demo menu in Google Spreadsheets.
 */
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("Sentiment Tools")
    .addItem("Mark entities and sentiment", "markEntitySentiment")
    .addToUi();
}

/**
 * Analyzes entities and sentiment for each comment in
 * Review Data sheet and copies results into the
 * Entity Sentiment Data sheet.
 */
function markEntitySentiment() {
  // Sets variables for "Review Data" sheet
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const dataSheet = ss.getSheetByName("Review Data");
  const rows = dataSheet.getDataRange();
  const numRows = rows.getNumRows();
  const values = rows.getValues();
  const headerRow = values[0];

  // Checks to see if "Entity Sentiment Data" sheet is present, and
  // if not, creates a new sheet and sets the header row.
  const entitySheet = ss.getSheetByName("Entity Sentiment Data");
  if (entitySheet == null) {
    ss.insertSheet("Entity Sentiment Data");
    const entitySheet = ss.getSheetByName("Entity Sentiment Data");
    const esHeaderRange = entitySheet.getRange(1, 1, 1, 6);
    const esHeader = [
      [
        "Review ID",
        "Entity",
        "Salience",
        "Sentiment Score",
        "Sentiment Magnitude",
        "Number of mentions",
      ],
    ];
    esHeaderRange.setValues(esHeader);
  }

  // Finds the column index for comments, language_detected,
  // and comments_english columns.
  const textColumnIdx = headerRow.indexOf(COLUMN_NAME.COMMENTS);
  const entityColumnIdx = headerRow.indexOf(COLUMN_NAME.ENTITY);
  const idColumnIdx = headerRow.indexOf(COLUMN_NAME.ID);
  if (entityColumnIdx === -1) {
    Browser.msgBox(
      `Error: Could not find the column named ${COLUMN_NAME.ENTITY}. Please create an empty column with header "entity_sentiment" on the Review Data tab.`,
    );
    return; // bail
  }

  ss.toast("Analyzing entities and sentiment...");
  for (let i = 0; i < numRows; ++i) {
    const value = values[i];
    const commentEnCellVal = value[textColumnIdx];
    const entityCellVal = value[entityColumnIdx];
    const reviewId = value[idColumnIdx];

    // Calls retrieveEntitySentiment function for each row that has a comment
    // and also an empty entity_sentiment cell value.
    if (commentEnCellVal && !entityCellVal) {
      const nlData = retrieveEntitySentiment(commentEnCellVal);
      // Pastes each entity and sentiment score into Entity Sentiment Data sheet.
      const newValues = [];
      for (let entity in nlData.entities) {
        entity = nlData.entities[entity];
        const row = [
          reviewId,
          entity.name,
          entity.salience,
          entity.sentiment.score,
          entity.sentiment.magnitude,
          entity.mentions.length,
        ];
        newValues.push(row);
      }
      if (newValues.length) {
        entitySheet
          .getRange(
            entitySheet.getLastRow() + 1,
            1,
            newValues.length,
            newValues[0].length,
          )
          .setValues(newValues);
      }
      // Pastes "complete" into entity_sentiment column to denote completion of NL API call.
      dataSheet.getRange(i + 1, entityColumnIdx + 1).setValue("complete");
    }
  }
}

/**
 * Calls the Cloud Natural Language API with a string of text to analyze
 * entities and sentiment present in the string.
 * @param {String} the string for entity sentiment analysis
 * @return {Object} the entities and related sentiment present in the string
 */
function retrieveEntitySentiment(line) {
  const apiKey = myApiKey;
  const apiEndpoint = `https://language.googleapis.com/v1/documents:analyzeEntitySentiment?key=${apiKey}`;
  // Creates a JSON request, with text string, language, type and encoding
  const nlData = {
    document: {
      language: "en-us",
      type: "PLAIN_TEXT",
      content: line,
    },
    encodingType: "UTF8",
  };
  // Packages all of the options and the data together for the API call.
  const nlOptions = {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify(nlData),
  };
  // Makes the API call.
  const response = UrlFetchApp.fetch(apiEndpoint, nlOptions);
  return JSON.parse(response);
}

Współtwórcy

Ten przykład jest obsługiwany przez Google przy pomocy ekspertów Google Developers.

Analizowanie nastawienia w opiniach za pomocą interfejsu Google Cloud Natural Language API Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.