Halaman ini diterjemahkan oleh Cloud Translation API.

Menghubungkan ke API: Menganalisis sentimen masukan

Tingkat coding: Menengah
Durasi: 20 menit
Jenis project: Otomatisasi dengan menu kustom

Tujuan

Pahami fungsi solusi.
Pahami fungsi layanan Apps Script dalam solusi.
Siapkan lingkungan Anda.
Siapkan skrip.
Jalankan skrip.

Tentang solusi ini

Anda dapat menganalisis data teks, seperti masukan terbuka, dalam skala besar. Untuk melakukan analisis sentimen dan entitas dari dalam Google Spreadsheet, solusi ini menggunakan UrlFetch Service untuk terhubung ke Google Cloud Natural Language API.

diagram cara kerja analisis sentimen

Cara kerjanya

Skrip mengumpulkan teks dari spreadsheet dan terhubung ke Google Cloud Natural Language API untuk menganalisis entity dan sentimen yang ada dalam string. Tabel pivot merangkum skor sentimen rata-rata untuk setiap entitas yang disebutkan di semua baris data teks.

Layanan Apps Script

Solusi ini menggunakan layanan berikut:

Layanan spreadsheet–Mengirim data teks ke Google Cloud Natural Language API dan menandai setiap baris sebagai "Selesai" setelah sentimennya dianalisis.
Layanan UrlFetch–Terhubung ke Google Cloud Natural Language API untuk melakukan analisis entity dan sentimen pada teks.

Prasyarat

Untuk menggunakan sampel ini, Anda memerlukan prasyarat berikut:

Akun Google (akun Google Workspace mungkin memerlukan persetujuan administrator).
Browser web dengan akses ke internet.
Project Google Cloud dengan akun penagihan terkait. Lihat Mengaktifkan penagihan untuk project.

Menyiapkan lingkungan Anda

Buka project Cloud Anda di konsol Google Cloud

Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:

Di konsol Google Cloud, buka halaman Select a project.
Pilih project Cloud
Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.

Aktifkan Google Cloud Natural Language API

Solusi ini terhubung ke Google Cloud Natural Language API. Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.

Di project Cloud Anda, aktifkan Google Cloud Natural Language API.

Mengaktifkan API

Mengonfigurasi layar izin OAuth

Solusi ini memerlukan project Cloud dengan layar izin yang dikonfigurasi. Mengonfigurasi layar izin OAuth menentukan konten yang ditampilkan Google kepada pengguna dan mendaftarkan aplikasi Anda sehingga Anda dapat memublikasikannya nanti.

Di Konsol Google Cloud, buka Menu > Google Auth platform > Branding.
Buka Branding
Jika sudah mengonfigurasi Google Auth platform, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth platform belum dikonfigurasi, klik Mulai:

Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
Klik Berikutnya.
Di bagian Audiens, pilih Internal.
Klik Berikutnya.
Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
Klik Berikutnya.
Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Google API Services: User Data Policy.
Klik Lanjutkan.
Klik Buat.

Untuk saat ini, Anda dapat melewati penambahan cakupan. Pada masa mendatang, saat Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal. Kemudian tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan Mengonfigurasi izin OAuth selengkapnya.

Mendapatkan kunci API untuk Google Cloud Natural Language API

Buka Konsol Google Cloud. Pastikan project yang mengaktifkan penagihan Anda terbuka.
Di Konsol Google Cloud, buka Menu > APIs & Services > Credentials.

Buka Kredensial
Klik Create credentials > API key.
Catat kunci API Anda untuk digunakan pada langkah selanjutnya.

Menyiapkan skrip

Buat project Apps Script

Klik tombol di bawah untuk membuat salinan contoh spreadsheet Analisis sentimen untuk umpan balik. Project Apps Script untuk solusi ini dilampirkan ke spreadsheet.
Buat salinan
Klik Ekstensi > Apps Script.
Perbarui variabel berikut dalam file skrip dengan kunci API Anda:
```
const myApiKey = 'YOUR_API_KEY'; // Replace with your API key.
```
Klik Simpan .

Menambahkan data teks

Kembali ke spreadsheet.
Tambahkan data teks ke kolom id dan comments. Anda dapat menggunakan contoh ulasan properti liburan dari Kaggle atau menggunakan data Anda sendiri. Anda dapat menambahkan lebih banyak kolom jika diperlukan, tetapi agar berhasil dijalankan, skrip harus memiliki data di kolom id dan comments.

Jalankan skrip:

Di bagian atas spreadsheet, klik Alat Analisis Sentimen > Tandai entitas dan sentimen. Anda mungkin perlu memuat ulang halaman agar menu kustom ini muncul.
Saat diminta, izinkan skrip. Jika layar izin OAuth menampilkan peringatan Aplikasi ini belum diverifikasi, lanjutkan dengan memilih Lanjutan > Buka {Project Name} (tidak aman).
Klik Alat Sentimen > Tandai entitas dan sentimen lagi.
Setelah skrip selesai, beralihlah ke sheet Tabel Pivot untuk melihat hasilnya.

Meninjau kode

Untuk meninjau kode Apps Script untuk solusi ini, klik Lihat kode sumber di bawah:

Melihat kode sumber

Code.gs

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

Lihat di GitHub

// 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);
};

Kontributor

Contoh ini dikelola oleh Google dengan bantuan Pakar Developer Google.

Menghubungkan ke API: Menganalisis sentimen masukan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.