コーディング レベル: 中級
所要時間: 20 分
プロジェクトの種類: カスタム メニューを使用した自動化
目標
- ソリューションの機能を理解します。
- Apps Script サービスがソリューション内でどのように機能するかを理解します。
- 環境を設定する。
- スクリプトを設定します。
- スクリプトを実行します。
このソリューションについて
自由回答形式のフィードバックなどのテキストデータを大規模に分析できます。このソリューションでは、Google スプレッドシート内からエンティティと感情の分析を行うために、UrlFetch Service を使用して Google Cloud Natural Language API に接続します。
仕組み
このスクリプトは、スプレッドシートからテキストを収集し、Google Cloud Natural Language API に接続して、文字列に含まれるエンティティと感情を分析します。ピボット テーブルは、テキストデータのすべての行について言及された各エンティティの平均感情スコアを要約します。
Apps Script サービス
このソリューションでは、次のサービスを使用します。
- スプレッドシート サービス - テキストデータを Google Cloud Natural Language API に送信し、感情が分析されたら各行に「完了」のマークを付けます。
- UrlFetch サービス - Google Cloud Natural Language API に接続して、テキストのエンティティ分析と感情分析を行います。
前提条件
このサンプルを使用するには、次の前提条件を満たす必要があります。
- Google アカウント(Google Workspace アカウントの場合、管理者の承認が必要になる場合があります)。
インターネットにアクセスできるウェブブラウザ。
請求先アカウントが関連付けられた Google Cloud プロジェクト。プロジェクトの課金を有効にするをご覧ください。
環境を設定する
Google Cloud コンソールで Cloud プロジェクトを開く
まだ開いていない場合は、このサンプルで使用する Cloud プロジェクトを開きます。
- Google Cloud コンソールで [プロジェクトの選択] ページに移動します。
- 使用する Google Cloud プロジェクトを選択します。または、[プロジェクトを作成] をクリックし、画面の指示に従います。Google Cloud プロジェクトを作成する場合は、プロジェクトの課金を有効にすることが必要な場合があります。
Google Cloud Natural Language API を有効にする
このソリューションは、Google Cloud Natural Language API に接続します。Google API を使用する前に、Google Cloud プロジェクトで API を有効にする必要があります。1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。
Cloud プロジェクトで、Google Cloud Natural Language API を有効にします。
OAuth 同意画面を構成する
このソリューションでは、同意画面が構成された Cloud プロジェクトが必要です。OAuth 同意画面を構成すると、Google がユーザーに表示する内容を定義し、後で公開できるようにアプリを登録します。
- Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。
- [ユーザーの種類] で [内部] を選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して次へ] をクリックします。
現時点では、スコープの追加をスキップして、[Save and Continue] をクリックします。今後、Google Workspace 組織外で使用するアプリを作成する場合は、[ユーザータイプ] を [外部] に変更してから、アプリに必要な認証スコープを追加する必要があります。
- アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリ登録に問題がない場合は、[Back to Dashboard] をクリックします。
Google Cloud Natural Language API の API キーを取得する
- Google Cloud コンソールに移動します。 課金が有効になっているプロジェクトが開いていることを確認します。
Google Cloud コンソールで、メニュー > [API とサービス] > [認証情報] に移動します。
[認証情報を作成] > [API キー] をクリックします。
後のステップで使用するために、API キーをメモしておきます。
スクリプトを設定する
Apps Script プロジェクトを作成する
- 下のボタンをクリックすると、フィードバックの感情分析のサンプル スプレッドシートのコピーが作成されます。このソリューションの Apps Script プロジェクトは、スプレッドシートに添付されています。
コピーを作成 - [拡張機能] > [Apps Script] をクリックします。
- スクリプト ファイルの次の変数を API キーで更新します。
const myApiKey = 'YOUR_API_KEY'; // Replace with your API key.
- [保存] をクリックします。
テキストデータを追加する
- スプレッドシートに戻ります。
- id 列と comments 列にテキストデータを追加します。Kaggle からサンプルの民泊施設のレビューを使用することも、独自のデータを使用することもできます。必要に応じて列を追加できますが、スクリプトを正常に実行するには、スクリプトの id 列と comments 列にデータが含まれている必要があります。
スクリプトを実行する
- スプレッドシートの上部にある [Sentiment Tools] > [Mark entity and sentiment] をクリックします。このカスタム メニューを表示するには、ページの更新が必要になる場合があります。
プロンプトが表示されたら、スクリプトを承認します。OAuth 同意画面に「このアプリは確認されていません」という警告が表示された場合は、[詳細設定] > [{プロジェクト名}(安全でない)に移動] を選択します。
[Sentiment Tools] > [Mark entity and sentiment] を再度クリックします。
スクリプトが終了したら、[ピボット テーブル] シートに切り替えて結果を確認します。
コードを確認する
このソリューションの Apps Script コードを確認するには、下の [ソースコードを表示] をクリックします。
ソースコードを表示
Code.gs
協力者
このサンプルは、Google Developer Experts の協力により Google が保守しています。
次のステップ
- ブログ: Google Cloud Natural Language API と Apps Script を使用して Google スプレッドシートのテキストを分析する
- Google Cloud Natural Language API ドキュメント