- PowerShell×Google APIシリーズ
- PowerShellでGoogleカレンダーに簡単に予定を追加
- QuickAddという魔法
- 日本語の場合は引数のTextに注意
- 終わりに
- PowerShellによる自動化？的な関連記事
PowerShell×Google APIシリーズ
PowerShellでGoogle APIを使ってGoolgeカレンダーを操作する - 適材適所
PowerShellでGoogle APIを使ってGoogleカレンダーを操作する その２～予定を追加する～ - 適材適所
https://www.tekizai.net/entry/googlecalendar_powershell_3
PowerShellでGoogleカレンダーに簡単に予定を追加
こちらの記事では、PowerShellを使って、Googleカレンダーに予定を追加するオーソドックスな方法を紹介しました。
下記のコードです。
#dllのロード、OAuth認証は省略 ##Create Google Calendar API service. $baseClient=New-Object Google.Apis.Services.BaseClientService+Initializer $baseClient.HttpClientInitializer =$credential $baseClient.ApplicationName=$ApplicationName $service=New-Object Google.Apis.Calendar.v3.CalendarService($baseClient) #新しいイベントを作成します $newEvent=New-Object Google.Apis.Calendar.v3.Data.Event $newEvent.Summary="Google Api Test"$newEvent.Location="東京都中央区" $newEvent.Description="meeting" #開始日$start=New-Object Google.Apis.Calendar.v3.Data.EventDateTime $start.DateTime=[System.DateTime]::Parse("2020/7/1 10:00:00") $start.TimeZone="Asia/Tokyo" #終了日$end=New-Object Google.Apis.Calendar.v3.Data.EventDateTime $end.DateTime=[System.DateTime]::Parse("2020/7/1 12:00:00") $end.TimeZone="Asia/Tokyo" $newEvent.Start=$start $newEvent.End=$end $calendarId="primary" $request=$service.Events.Insert($newEvent,$calendarId) $createdEvent=$request.Execute()
この書き方は王道な書き方です。
他の参加者や、予定の繰り返しなど、
全ての項目を細かいものも含めて隈なく設定できるのですが、
多くの場合、そこまで細かい設定はせず、
ただ開始日と終了日、件名くらいしか登録しないのではないでしょうか。
Google先生は、そんなこともお見通しです。
そして、そんな面倒臭がり屋さんのために
ちゃんと簡単に予定を追加する方法を提供してくれているです。
QuickAddという魔法
なんとEventsオブジェクトのQuickAddメソッドを使うことで、
簡単に予定を追加することができます。
Creates an event based on a simple text string
とあるように、
こちらのQuickAddメソッドは、
簡単な文字列からEventを追加することができます。
Appointment at Somewhere on June 3rd 10am-10:25am
こんな英語のテストみたいな文字列で
予定を追加できるなんて素敵！！
リンクの公式リファレンスには
.NETの例はありませんが、他の言語のサンプルから、
なんとなく雰囲気がわかりますね。
ちなみに.NETのQuickAddの構文はこうなっています。
OverloadDefinitions ------------------- Google.Apis.Calendar.v3.EventsResource+QuickAddRequest QuickAdd(string calendarId, string text)
これを踏まえて、PowerShell(.NET)で
QuickAddを使って予定を追加してみます。
#dllのロード、OAuth認証は省略 ##Create Google Calendar API service. $baseClient=New-Object Google.Apis.Services.BaseClientService+Initializer $baseClient.HttpClientInitializer =$credential $baseClient.ApplicationName=$ApplicationName $service=New-Object Google.Apis.Calendar.v3.CalendarService($baseClient) $service.Events.QuickAdd("primary",'2020年6月3日 10am-10:25am 約束').execute()
最初に出てきたInsertの例と比べると、
追加の処理が１行で済んでおり、
予定の追加コードがとても簡素化されています。
日本語の場合は引数のTextに注意
引数のTextについては、どのように書いたらどのように動作するのか、
公式リファレンスにはあまり詳しく書いておりません。
公式リファレンスでは、Textについて、
The text describing the event to be created.
とだけ書かれています。
ちょっと素っ気ない気がしますが・・・。
もう少し、どんな風に書いたらいいか等の説明が欲しいところですね・・・。
ということで、日本語ではどんなケースは登録できて、
どんなケースが登録できないのか、少し実験してみました。
Version
Google.Apis.Calendar.v3 1.46.0.1986
これはOK
2020/6/3 10am-10:25am 約束 2020年6月3日 10am-10:25am 約束
これはNG
6月3日 10am-10:25am 約束 ⇒「6月3日約束」という名前で、明日(コマンドを実行した日の次の日)の日付で登録されてしまいました。
2020年6月3日 10:00-10:25 約束 ⇒「約束」という名前で、6月4日の終日の予定として登録されてしまいました。
2020年6月3日 午前10時-午前10時25分 約束 ⇒「約束」という名前で、6月4日の終日の予定として登録されてしまいました。
2020年6月3日 約束 東京にて ⇒「約束 東京にて」という名前で6月4日の終日の予定として登録されてしまいました。
2020年6月3日 約束 at 東京 ⇒「約束 at 東京」という名前で6月4日の終日の予定として登録されてしまいました。
ここから言えること
・日付はyyyy/M/dでも、yyyy年Ｍ月d日のどちらでも大丈夫 ・時間指定は、「10am-10:25am」の書式に従う必要があること ・時間指定の書式が正しくなかったり、指定しないと指定した日の翌日になってしまう？ ・場所の指定はできない？
⇒どうも本当に簡単な予定(開始日、終了日、サマリーくらい)しか登録できなさそうです。
また、日本語でうまく場所を指定することができませんでした。
うーん。
アプローチが悪いのでしょうか。
もっと調査が必要ですね。
終わりに
PowerShellでGoogle Calendarに
QuickAddで予定を追加する方法を紹介しました。
確かに簡単に予定を追加することができますが、
通常の方法と比べ、限定された項目しか設定できないこと、
また、どんなテキストを与えれば正しく追加できるか、
若干クセがあること等を念頭に置いて使い分けが必要ですね。
Google先生の進化は目覚しいものがありますので
APIのVersionも日々上がっていって
どんどん精巧になっていくことでしょう。
Google先生！もっと簡単なQuickAddをお願いします！！
というわけで、ここまでお読みいただき、ありがとうございました。