GSP1301

Ringkasan

Add-in dapat mengembangkan kemampuan Google Workspace untuk membantu pengguna menjadi lebih produktif dan efisien. Dalam lab ini, Anda akan membuat add-on Google Workspace yang memanfaatkan kecanggihan Gemini dan Vertex AI untuk melakukan analisis sentimen di Gmail. Anda akan menyiapkan resource cloud yang diperlukan (termasuk API Vertex AI), mengonfigurasi project Apps Script, dan men-deploy add-on.

Add-on ini memungkinkan Anda mengidentifikasi dan melabeli email negatif secara otomatis. Anda dapat menggunakannya untuk mengatur prioritas layanan pelanggan dan mendeteksi email yang mungkin sensitif dengan cepat.

Di akhir lab, Anda akan memiliki alat fungsional yang menunjukkan pemanfaatan praktis AI untuk meningkatkan produktivitas dan komunikasi dalam konteks bisnis.

Yang akan Anda pelajari

Di lab ini, Anda akan melakukan hal berikut:

• Membuat add-on Google Workspace yang mengembangkan fungsi Gmail.
• Mengintegrasikan Vertex AI dengan Google Workspace untuk menggunakan Gemini dan kemampuan natural language processing Vertex AI dalam sebuah add-on Gmail.
• Menerapkan autentikasi OAuth2 untuk memberi add-on ini akses ke data pengguna secara aman.
• Menjalankan analisis sentimen untuk menganalisis konten email secara terprogram guna menentukan nuansa emosionalnya.
• Memanfaatkan kode Tulis Apps Script untuk berinteraksi dengan Gmail, mengelola antarmuka pengguna, dan terhubung ke API eksternal.

Penyiapan dan persyaratan

Sebelum mengklik tombol Start Lab

Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.

Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.

Untuk menyelesaikan lab ini, Anda memerlukan:

• Akses ke browser internet standar (disarankan browser Chrome).

Catatan: Gunakan jendela Samaran (direkomendasikan) atau browser pribadi untuk menjalankan lab ini. Hal ini akan mencegah konflik antara akun pribadi Anda dan akun siswa yang dapat menyebabkan tagihan ekstra pada akun pribadi Anda.

• Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.

Catatan: Hanya gunakan akun siswa untuk lab ini. Jika Anda menggunakan akun Google Cloud yang berbeda, Anda mungkin akan dikenai tagihan ke akun tersebut.

Cara memulai lab dan login ke Google Cloud Console

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran. Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk mengakses produk dan layanan Google Cloud, klik Navigation menu atau ketik nama layanan atau produk di kolom Search.

Tugas 1. Mengakses lingkungan lab

Anda sudah login ke Konsol Google Cloud. Sekarang, login ke Gmail.

1. Klik Open Gmail untuk membuka halaman login Gmail.

Tips: Buka tab-tab ini di jendela browser terpisah agar lebih mudah dilihat.

2. Login ke Gmail menggunakan Nama pengguna dan Sandi, .

Catatan: Kredensial ini juga ada di panel Lab details dan digunakan untuk login ke Konsol Google Cloud.

3. Setelah login ke Gmail, klik Get started dan tutup jendela informasi apa pun. Sekarang, Anda dapat melihat Kotak Masuk.

Anda sudah siap untuk memulai aktivitas lab.

Tugas 2. Mengonfigurasi lingkungan Google Cloud

Dalam tugas ini, Anda akan mengaktifkan Vertex AI API, lalu mengonfigurasi layar izin OAuth untuk menentukan konten yang ditampilkan Google Workspace kepada pengguna.

Mengaktifkan Vertex AI API

1. Di Konsol Google Cloud, di Navigation menu, klik APIs and Services > Library.

2. Ketik Vertex AI API di dalam kotak Search for APIs & Services, lalu klik Vertex AI API di hasil penelusuran.

3. Klik Enable untuk mengaktifkan API.

Halaman API/Service Details akan terbuka.

Mengonfigurasi layar izin OAuth

1. Di panel kiri, klik OAuth consent screen.

2. Klik Get Started.

3. Untuk App Information, ikuti pengaturan berikut, lalu klik Next:

• App name: Gmail Sentiment Analysis with Gemini and Vertex AI
• User support email:

4. Untuk Audience, pilih Internal, lalu klik Next.
5. Untuk Contact Information, gunakan sebagai Email address, lalu klik Next.
6. Untuk Finish, setujui Google API Services: User Data Policy, lalu klik Continue.
7. Klik Create.

Klik Periksa progres saya untuk memverifikasi tujuan. Mengonfigurasi layar izin OAuth.

Tugas 3. Menyiapkan project Apps Script

Dalam tugas ini, Anda akan membuat dan mengonfigurasi add-on sebagai project Apps Script.

Mendapatkan nomor project Google Cloud Anda

Untuk mendapatkan nomor project Google Cloud yang akan digunakan saat membuat project Apps Script:

1. Di Navigation menu (), klik Cloud overview > Dashboard.

2. Dari bagian Project info, catat Project number untuk digunakan nanti di lab ini.

Membuat project Apps Script

1. Di panel Student Resources, klik link ini, script.google.com/ untuk membuka halaman Apps Script.

2. Klik New project untuk membuat project Apps Script.

3. Beri nama project Anda:

   • Klik "Untitled project" di kiri atas.
   • Beri nama project Gmail Sentiment Analysis with Gemini and Vertex AI, lalu klik Rename.

4. Buat file manifes terlihat:

   • Di panel kiri, klik Project Settings ().
   • Pilih Show 'appsscript.json' manifest file in editor.

5. Ubah project Google Cloud Platform:

   • Scroll ke bagian Google Cloud Platform (GCP) Project, lalu klik Change project.
   • Gunakan nomor project yang sebelumnya Anda catat sebagai GCP project number.
   • Klik Set project.

Klik Periksa progres saya untuk memverifikasi tujuan. Membuat project Apps Script.

Tugas 4. Mengisi file kode

• Di panel kiri, klik Editor () untuk membuka jendela editor.

Ikuti petunjuk di bawah untuk mengupdate project Anda dengan kode contoh.

appsscript.json

1. Buka appsscript.json dan ganti isi filenya dengan ini:

{ "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" }

2. Klik Save untuk menyimpan project.

Code.gs

1. Buka Code.gs dan ganti isinya dengan ini:

/* 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. */ // Ganti dengan ID project Anda const PROJECT_ID = '{{{project_0.project_id | Project ID}}}'; // Lokasi model Vertex AI Anda const VERTEX_AI_LOCATION = 'us-east4'; // ID Model untuk analisis sentimen const MODEL_ID = 'gemini-2.0-flash'; /** * Terpicu saat add-on dibuka dari halaman beranda Gmail. * * @param {Object} e - Objek event. * @returns {Card} - Kartu halaman beranda. */ function onHomepageTrigger(e) { return buildHomepageCard(); } /** * Membuat kartu utama yang ditampilkan di halaman beranda Gmail. * * @returns {Card} - Kartu halaman beranda. */ function buildHomepageCard() { // Buat builder kartu baru const cardBuilder = CardService.newCardBuilder(); // Buat header kartu 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"); // Tambahkan header ke kartu cardBuilder.setHeader(cardHeader); // Buat bagian kartu const cardSection = CardService.newCardSection(); // Buat tombol untuk membuat email sampel dan menganalisis sentimennya const buttonSet = CardService.newButtonSet(); // Buat tombol "Generate sample emails" const generateButton = createFilledButton('Generate sample emails', 'generateSampleEmails', '#34A853'); buttonSet.addButton(generateButton); // Buat tombol "Analyze emails" const analyzeButton = createFilledButton('Analyze emails', 'analyzeSentiment', '#FF0000'); buttonSet.addButton(analyzeButton); // Tambahkan set tombol ke bagian tersebut cardSection.addWidget(buttonSet); // Tambahkan bagian ke kartu cardBuilder.addSection(cardSection); // Buat dan munculkan kartu return cardBuilder.build(); } /** * Membuat tombol berisi teks dengan teks, fungsi, dan warna yang ditentukan. * * @param {string} text - Teks yang akan ditampilkan di tombol. * @param {string} functionName - Nama fungsi yang akan dipanggil saat tombol diklik. * @param {string} color - Warna latar belakang tombol. * @returns {TextButton} - Tombol teks yang dibuat. */ function createFilledButton(text, functionName, color) { // Buat tombol teks baru const textButton = CardService.newTextButton(); // Atur teks tombol textButton.setText(text); // Tetapkan tindakan yang akan dilakukan saat tombol diklik const action = CardService.newAction(); action.setFunctionName(functionName); textButton.setOnClickAction(action); // Gunakan filled sebagai gaya tombol textButton.setTextButtonStyle(CardService.TextButtonStyle.FILLED); // Tentukan warna latar belakang textButton.setBackgroundColor(color); return textButton; } /** * Membuat respons notifikasi dengan teks yang ditentukan. * * @param {string} notificationText - Teks yang akan ditampilkan di notifikasi. * @returns {ActionResponse} - Respons tindakan yang dibuat. */ function buildNotificationResponse(notificationText) { // Buat notifikasi baru const notification = CardService.newNotification(); notification.setText(notificationText); // Buat builder respons tindakan baru const actionResponseBuilder = CardService.newActionResponseBuilder(); // Atur notifikasi untuk respons tindakan actionResponseBuilder.setNotification(notification); // Buat dan hasilkan respons tindakan return actionResponseBuilder.build(); } /** * Membuat email sampel untuk menguji analisis sentimen. * * @returns {ActionResponse} - Notifikasi yang mengonfirmasi pembuatan email. */ function generateSampleEmails() { // Ambil alamat email pengguna saat ini const userEmail = Session.getActiveUser().getEmail(); // Tentukan email sampel 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: `

Hello, You are late in delivery, again.

Please contact me ASAP before I cancel our subscription.

`, name: 'Customer C' } ]; // Kirim tiap email sampel for (const email of sampleEmails) { GmailApp.sendEmail(userEmail, email.subject, email.body, { name: email.name, htmlBody: email.htmlBody }); } // Munculkan notifikasi return buildNotificationResponse("Successfully generated sample emails"); } /** * Menganalisis sentimen dari 10 rangkaian email pertama di kotak masuk * dan melabelinya dengan benar. * * @returns {ActionResponse} - Notifikasi yang mengonfirmasi penyelesaian. */ function analyzeSentiment() { // Analisis dan labeli email analyzeAndLabelEmailSentiment(); // Munculkan notifikasi= return buildNotificationResponse("Successfully completed sentiment analysis"); } /** * Menganalisis sentimen dari email dan memberikan label yang benar. */ function analyzeAndLabelEmailSentiment() { // Tentukan nama label const labelNames = ["HAPPY TONE 😊", "NEUTRAL TONE 😐", "UPSET TONE 😡"]; // Dapatkan atau buat label untuk tiap sentimen 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]); // Ambil 10 rangkaian pesan pertama di kotak masuk const threads = GmailApp.getInboxThreads(0, 10); // Lakukan iterasi dengan tiap rangkaian pesan for (const thread of threads) { // Lakukan iterasi dengan tiap pesan di rangkaian const messages = thread.getMessages(); for (const message of messages) { // Ambil teks isi pesan const emailBody = message.getPlainBody(); // Analisis sentimen isi email const sentiment = processSentiment(emailBody); // Berikan label yang sesuai ke tiap sentimen if (sentiment === 'positive') { thread.addLabel(positiveLabel); } else if (sentiment === 'neutral') { thread.addLabel(neutralLabel); } else if (sentiment === 'negative') { thread.addLabel(negativeLabel); } } } } /** * Mengirimkan teks email ke Vertex AI untuk analisis sentimen. * * @param {string} emailText - Teks email yang akan dianalisis. * @returns {string} - Sentimen email ('positive', 'negative', atau 'neutral'). */ function processSentiment(emailText) { // Bangun URL endpoint API const apiUrl = `https://${VERTEX_AI_LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION}/publishers/google/models/${MODEL_ID}:generateContent`; // Siapkan payload permintaan const payload = { contents: [ { role: "user", parts: [ { text: `Analyze the sentiment of the following message: ${emailText}` } ] } ], generationConfig: { temperature: 0.9, maxOutputTokens: 1024, responseMimeType: "application/json", // Format respons yang diharapkan untuk penguraian (parsing) yang lebih sederhana. responseSchema: { type: "object", properties: { response: { type: "string", enum: ["positive", "negative", "neutral"] } } } } }; // Siapkan opsi permintaan 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) }; // Buat permintaan API const response = UrlFetchApp.fetch(apiUrl, options); // Uraikan respons. Ada dua tingkat respons JSON yang perlu diuraikan. const parsedResponse = JSON.parse(response.getContentText()); const sentimentResponse = JSON.parse(parsedResponse.candidates[0].content.parts[0].text).response; // Hasilkan sentimen return sentimentResponse; }

Klik Save untuk menyimpan project.

Tugas 5. Men-deploy add-on

Dalam tugas ini, Anda akan men-deploy add-on, lalu memverifikasi penginstalannya.

Men-deploy add-on

1. Di kolom judul, klik Deploy > Test deployments.

2. Pastikan Gmail tercantum untuk Application(s), lalu klik Install.

3. Klik Done.

Memverifikasi penginstalan

• Muat ulang tab Gmail. Anda akan melihat ikon di panel kanan.

Memecahkan masalah

Jika add-on Anda tidak ada di daftar, muat ulang jendela browser.

Jika masih tidak ada, kembali ke project Apps Script, uninstal add-on dari jendela Test deployments, lalu instal ulang.

Tugas 6. Menjalankan add-on

Sekarang, Anda sudah siap menjalankan add-on. Dalam tugas ini, Anda akan membuka dan memberi add-on akses, lalu membuat email untuk memverifikasi bahwa analisis berfungsi.

1. Masih di Gmail, di panel kanan, klik Sentiment Analysis ().

2. Saat panel samping terbuka, klik Authorize access untuk memberi add-on izin supaya dapat berjalan.

Layar izin akan terbuka. Pilih email Anda () dan klik layar untuk mengizinkan akses.

Setelah Anda memberikan izin, panel Sentiment Analysis akan terbuka di sebelah kanan.

3. Di panel Sentiment Analysis, klik Generate sample emails.

Add-on pun membuat sampel email untuk menguji analisis. Pesan akan ditampilkan setelah pembuatan selesai, yang hanya memerlukan waktu beberapa detik.

4. Tunggu email sampel muncul di kotak masuk Anda. Anda mungkin harus memuat ulang kotak masuk untuk melihat email baru.

5. Setelah email sampel berada di kotak masuk Anda, di panel Sentiment Analysis, klik Analyze emails.

Pesan bahwa analisis telah selesai akan ditampilkan di bagian bawah layar add-on.

Catatan :Menganalisis email dapat memerlukan waktu. Anda dapat memuat ulang halaman untuk memeriksa status label yang diterapkan.

Add-on ini menganalisis email dan menerapkan label yang sesuai ("HAPPY TONE 😊", "UPSET TONE 😡", atau "NEUTRAL TONE 😐") ke pesan di kotak masuk Anda.

Anda mungkin harus memuat ulang Gmail untuk melihat label yang diterapkan.

7. Lanjutkan Eksperimen Anda dapat menguji add-on dengan mengirim email dengan berbagai sentimen (positif, negatif, netral) dari Gmail lab Anda ke akun Gmail lab lainnya. Email eksternal tidak diizinkan. Amati cara add-on menganalisis dan memberi label tiap email.

CATATAN: Kode ini hanya mengambil 10 email terakhir dari kotak masuk Anda, tetapi Anda dapat mengubah angka tersebut.

8. Tutup add-on: Setelah selesai menggunakan add-on, Anda dapat menutup add-on dengan mengklik X di pojok kanan atas panel samping.

Klik Periksa progres saya untuk memverifikasi tujuan. Menjalankan analisis sentimen.

Selamat!

Anda berhasil menyelesaikan lab Analisis Sentimen Gmail dengan Gemini dan Vertex AI.

Di lab ini, Anda telah mempelajari cara:

• Membuat add-on Google Workspace: Membuat alat praktis yang mengembangkan fungsi Gmail.
• Mengintegrasikan Vertex AI dengan Google Workspace: Menggunakan kemampuan natural language processing Gemini dan Vertex AI dalam sebuah add-on Gmail.
• Mengimplementasikan autentikasi OAuth2: Memberi add-on akses ke data pengguna dengan aman.
• Menjalankan analisis sentimen: Menganalisis konten email secara terprogram untuk menentukan nuansa emosional.
• Memanfaatkan Apps Script: Tulis kode untuk berinteraksi dengan Gmail dan , mengelola antarmuka pengguna, serta terhubung ke API eksternal.

Anda kini memiliki add-on Gmail fungsional yang dapat membantu mengatur prioritas email dan meningkatkan efisiensi kerja Anda. Jangan ragu untuk bereksperimen lebih lanjut dengan add-on ini, misalnya dengan menyesuaikan analisis sentimen atau menambahkan fitur baru.

Sertifikasi dan pelatihan Google Cloud

...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.

Manual Terakhir Diperbarui pada 25 Maret 2025

Lab Terakhir Diuji pada 25 Februari 2025

Hak cipta 2025 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.