Ta strona została przetłumaczona przez Cloud Translation API.

Połączenie z interfejsem API: analizowanie nastawienia w opiniach

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 nastawienia w Arkuszach Google, to rozwiązanie korzysta z usługi UrlFetch, która łączy się z interfejsem Google Cloud Natural Language API.

schemat działania 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 zawiera podsumowanie średniego wyniku nastawienia dla każdej wspomnianej encji 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 jego nastawienia.
Usługa UrlFetch – łączy się z interfejsem Google Cloud Natural Language API, aby przeprowadzić analizę encji i nastawienia w tekście.

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

Otwórz projekt w Google Cloud Console.

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

W konsoli Google Cloud otwórz stronę Wybierz projekt.
Wybierz projekt w chmurze
Wybierz projekt Google Cloud, którego chcesz użyć. 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 Google API, 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 Cloud.

Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

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

W konsoli Google Cloud otwórz Menu > Google Auth platform > Branding.
Otwórz Promowanie 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 sekcji Adres e-mail pomocy dla użytkowników wybierz adres e-mail, na który użytkownicy mogą pisać, 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 interfejsów API Google i jeśli się z nimi zgadzasz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów 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

Tworzenie projektu Apps Script

Kliknij poniższy przycisk, aby utworzyć kopię przykładowego arkusza kalkulacyjnego Analiza sentymentu 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 domach 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 wyświetlić to menu niestandardowe, konieczne może być odświeżenie strony.
Gdy pojawi się odpowiedni komunikat, autoryzuj skrypt. Jeśli na ekranie zgody OAuth wyświetla się ostrzeżenie Ta aplikacja nie została zweryfikowana, kliknij kolejno Zaawansowane > Otwórz {nazwa projektu} (niebezpieczne).
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 poniżej 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.
let 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
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  let dataSheet = ss.getSheetByName('Review Data');
  let rows = dataSheet.getDataRange();
  let numRows = rows.getNumRows();
  let values = rows.getValues();
  let 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.
  let entitySheet = ss.getSheetByName('Entity Sentiment Data');
  if (entitySheet == null) {
   ss.insertSheet('Entity Sentiment Data');
   let entitySheet = ss.getSheetByName('Entity Sentiment Data');
   let esHeaderRange = entitySheet.getRange(1,1,1,6);
   let 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.
  let textColumnIdx = headerRow.indexOf(COLUMN_NAME.COMMENTS);
  let entityColumnIdx = headerRow.indexOf(COLUMN_NAME.ENTITY);
  let 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) {
    let value = values[i];
    let commentEnCellVal = value[textColumnIdx];
    let entityCellVal = value[entityColumnIdx];
    let reviewId = value[idColumnIdx];

    // Calls retrieveEntitySentiment function for each row that has a comment 
    // and also an empty entity_sentiment cell value.
    if(commentEnCellVal && !entityCellVal) {
        let nlData = retrieveEntitySentiment(commentEnCellVal);
        // Pastes each entity and sentiment score into Entity Sentiment Data sheet.
        let newValues = []
        for (let entity in nlData.entities) {
          entity = nlData.entities [entity];
          let 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) {
  let apiKey = myApiKey;
  let apiEndpoint = 'https://language.googleapis.com/v1/documents:analyzeEntitySentiment?key=' + apiKey;
  // Creates a JSON request, with text string, language, type and encoding
  let 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.
  let nlOptions = {
    method : 'post',
    contentType: 'application/json',  
    payload : JSON.stringify(nlData)
  };
  // Makes the API call.
  let 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 ds. technologii.

Połączenie z interfejsem API: analizowanie nastawienia w opiniach Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.