Google Apps ScriptをPythonから起動してスプレッドシートのデータを、Gmailで送信したい

状況
・WindowsのPythonでスクレイピングをしている
・スプレイピング結果をGmailでお知らせする
・送信先や店舗名などマスタ情報はスプレッドシート上にある

環境
・python3.9 Windows10
・GoogleWorkspace Business Starter

まず考えたこと
①GmailAPIでメールを送信して、GoogleSheetsAPIでマスタ情報を取得しようか
→GmailAPIを使って送信者名を設定したり、htmlメールを送信する方法がわからない
→GmailAPI Python Quickstart
↑GmailAPIで送信者名を設定したり、htmlメールを送信する方法がわからなかった。どなたか教えてください。

②pythonのsmtplibを使ってGmailを送信しようか
→スプレッドシートのデータはGoogle Sheets APIをつかわないといけない。結局グーグルのAPIが必要だなー。

決めたこと

AppsScriptAPIを使ってPythonからGoogleAppsScriptを起動。スプレッドシートから必要なデータを取得して、Gmailを送信しよう

AppsScriptAPI公式ページ

グーグル検索に使ったキーワード

・GoogleCloudPlatform プロジェクト作成
・GoogleCloudPlatform apiを有効にする
・GoogleCloudPlatform 認証方法
・ExecutionAPI　使い方
・AppsScriptAPI　使い方
・GoogleAppScript　実行可能API

番号	見出し
1	GoogleAppsScriptの記述
2	Pythonの記述
3	GoogleAppsScriptの実行可能APIを呼び出すプログラムのポイント
設定手順
1	GoogleAppsScriptの作成(GAS)
2	プロジェクトの作成(GoogleCloudPlatform)
3	APIを有効にする(GoogleCloudPlatform)
4	Auth同意画面を作成する(GoogleCloudPlatform)
5	認証情報を作成する(GoogleCloudPlatform)
6	プロジェクトを関連づける(GoogleAppsScript)
7	実行可能APIとしてデプロイ(GoogleAppsScript)

まずはソースから
簡単な記述だけど、ネットの情報が古かったり、微妙に自分の求めているものとちがったり。
環境構築しないとコピペしても動かないので要注意。
環境構築内容はソースの後にメモしました。

※はまりポイントGoogleAppsScriptは単体で動作することを必ず確認すること

GoogleAppsScript


function testAPI(params){

　//下の内容は適時変更する
  const FROM_FORM="1〇〇〇f8sQLIYGQyeKeoqNnOOBP-IzpWWYDaabcdefg";  //スプレッドシートのID
  const FROM_SHEET="シート1";                                      //シート名
  const MAILADD="test〇〇〇〇@gmail.com";                           //メールの送信先
  const MAILTITLE="メールのタイトルです";                            //メールのタイトル
  const FROMNAME="山本やま子";                                      //メールの差出人

  //関数の引数がどのようになっているのか出力してみる
  Logger.log("型="+typeof(params));  
  Logger.log( params.test1 );
  Logger.log(params.test2)



  //スプレッドシートからA1の値を取得する
  let from_sheet = SpreadsheetApp.openById(FROM_FORM).getSheetByName(FROM_SHEET)
  let A1=from_sheet.getRange("A1").getValue()

  //スプレッドシートA１の内容をHTMLメールで送信してみる

  let html_body ="<html><body>リンク<br><a href='https://yahoo.co.jp'>A1の内容" + A1 + "</a></body></html>"

//MailApp.sendEmailの参考URL
//https://developers.google.com/apps-script/reference/mail/mail-app#sendEmail(String,String,String,Object)

  //メールを送信する
  MailApp.sendEmail(MAILADD, MAILTITLE, html_body, {name:'岩崎絵李子',htmlBody:html_body});

　//文字列をリターンしてみる
  return "aaaaaaaaaa";

}

pythonの記述

AppsScriptAPIを使ってGoogleAppsScriptの関数を呼び出す
Windows python3.9

python

from __future__ import print_function
import os.path
from googleapiclient import errors
from googleapiclient.discovery import build
from google_auth_oauthlib.flow import InstalledAppFlow
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials

def main():
    """Runs the sample.
    """
    # GoogleAppsScriptのデプロイIDのこと
    SCRIPT_ID = 'aaaaaAXc1Ebxd0-XKhjVVV〇〇〇4l0-7yMIf0ZdqzAMSiQlLQDbbbbbbb'

    #④GoogleCloudPlatformからダウンロードしたJSONファイル    
    #任意の場所で名前を変えてもOK。
    #謎の不具合解消のため、最初はフルパスで記入することをおすすめ。例はwindowsだよ。
    JSONFILE=r"C:\Users\test\Desktop\GmailApi\××××××××××××××.json"

    # ④GoogleCloudPlatformでAuth同意画面を作成する で選択したスコープのこと
    SCOPES = [
        'https://www.googleapis.com/auth/script.scriptapp',
        'https://www.googleapis.com/auth/script.send_mail',
        'https://www.googleapis.com/auth/spreadsheets'
    ]

    creds = None

　　#　プログラムのある場所にtoken.jsonが自動で作成されます。
    if os.path.exists('token.json'):
        creds = Credentials.from_authorized_user_file('token.json', SCOPES)

    # token.jsonがない場合ブラウザ上で認証画面が表示されます。
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(
                JSONFILE, SCOPES)
            creds = flow.run_local_server(port=0)

        with open('token.json', 'w') as token:
            token.write(creds.to_json())
    service = build('script', 'v1', credentials=creds)

    # GoogleAppsScriptで呼び出す関数名の設定・パラメータの設定
　　# 下の例だと 関数名=testAPI　キー=test1値=test1の文字
    request = {"function": "testAPI",
        "parameters":{'test1':'test1の文字','test2':'test2の文字'}
    }

    try:

        response = service.scripts().run(body=request,
                scriptId=SCRIPT_ID).execute()

        if 'error' in response:

            error = response['error']['details'][0]
            print("Script error message: {0}".format(error['errorMessage']))

            if 'scriptStackTraceElements' in error:

                print("Script error stacktrace:")
                for trace in error['scriptStackTraceElements']:
                    print("\t{0}: {1}".format(trace['function'],
                        trace['lineNumber']))
        else:

            #GoogleAppsScriptでreturanされた値　
            folderSet = response['response'].get('result', {})
            print(folderSet)

    except errors.HttpError as e:        
        print(e.content)


if __name__ == '__main__':
    main()

GoogleAppsScriptの実行可能APIを呼び出すプログラムのポイント

参考にしたのは以下の二つ
1 AppsScriptAPIサンプル
 2 認証部分のサンプル

1 AppsScriptAPIサンプルは認証部分が非推奨で古い、しかも、グーグルドライブを操作しています。
なので認証部分は2 認証部分のサンプルを参考にし、グーグルドライブの部分はスプレッドシートとGmailに置き換える必要があります。

①使うためにはライブラリのインストールが必要です。自分はWindowsなので先頭にpy -m を追加しています。

python

  py -m pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

※はまりポイント
pipしたのに、from googleapiclient import errors　が有効にならない。
→PCの再起動で解決

②■デプロイIDが必要

⑤実行可能APIのデプロイIDをコピーする
※はまりポイント
GoogleAppsScriptを変更するためにデプロイが必要。
更新後デプロイするときに「新しいデプロイ」を選ぶとデプロイIDが変わってしまうので、「デプロイを管理」を選んで「編集」→「デプロイ」をすればデプロイIDが変わらないので便利

③OAuthクライアント(Jsonファイル)が必要

Jsonファイルをダウンロードする
ファイル名は修正OK
※はまりポイント
exeファイルにした場合エラーがでるのでファイルの場所をフルパスで指定。

④　token.json には要注意

token.json、存在しない場合自動で作られます。
他のソースで上書きされないように。
謎の不具合が発生した場合、token.jsonを消すとうまくいくことも・・・

※はまりポイント
Auth同意画面を変更したり修正した場合、token.jsonも新たに必要です。
そのままだと更新されないのでいったん削除が必要

環境構築手順

①スプレッドシートの内容を読み込んでGmailを送信するスクリプトを作成する(GoogleAppsScript)

当然だけどここから。
初めてスクリプトを実行ときは認証画面が表示されるので認証を済ませる。
※はまりポイント
後ででてくるAuth同意画面との区別がつかなくなるので、GoogleAppsScriptの認証画面は前もって済ませておく
関数名をメモしておく。pythonプログラムで使います。

②GoogleCloudPlatformでプロジェクトを作成する

プロジェクトの作成方法は検索すればたくさんでてきます。
プロジェクトの作成方法
プロジェクトを作成したらプロジェクト番号を控える。（GoogleAppsScriptと関連付けるため)
プロジェクト番号はGoogleCloudPlatformのダッシュボードで確認できます。
ダッシュボード
※はまりポイント
プロジェクト名とログインIDを確認すること
特にログイン名は勝手に別のものに切り替わっています。
プロジェクト名も気が付くと別のプロジェクトに切り替わってました。

プロジェクト番号確認方法↓

③APIを有効にする(GoogleCloudPlatform)

今回は以下の３つを有効にしました
Google cloud platform apiを有効にする
・Apps Script API
・Gmail API
・Google Sheets API
※はまりポイント
APIはプロジェクトごとに有効にする。
以前有効にしたよと思ってもだめです。
プロジェクトごとに有効にしてください。

④Auth同意画面を作成する(GoogleCloudPlatform)

・内部でしか使わないので「内部」を選択し「作成」を押す

・次にでてくる「アプリ登録の編集」画面は認証画面デザインのこと。今回は社内の人しか見ないので適当でOK

・スコープの選択
GoogleAppScriptでスプレッドシートを読み込んでGmailを送信したいので以下の３つを選択します。
.../auth/script.scriptapp
.../auth/script.send_mail
.../auth/spreadsheets
Pythonのプログラムで↑のアドレスを使うのでこれとても重要です。

「スコープを追加または削除」ボタンを押すと以下のような画面が表示されるので、
.../auth/script.scriptapp
.../auth/script.send_mail
.../auth/spreadsheets
の３つを選択する
※はまりポイント
APIが有効になっていないと↑のアドレスでてきません。
表示されない場合はAPIが有効になっているかどうか確認する