[Feature Request] Add Hangouts Chat API functions

[scrthq]

Docs: https://developers.google.com/hangouts/chat/reference/

The functions added to PSGSuite specifically for this would provide REST API functionality only, but would allow actions like posting messages to rooms/DM's/etc, wherever webhooks are set up in Chat.

[scrthq]

This is now working in local, both with Webhooks and with the .NET SDK for Hangouts Chat.

Tidying up the last few issues to get the pipeline working the way I want it to and finishing up the documentation around this as well. Once done, this will be getting pushed up as a new release 😃

---

Webhook Notes

Webhooks are the most straightforward as far as additional setup is concerned. Specifically, you don't need to even have a PSGSuite config set up first in order to use Webhooks, since the Webhook URL contains the auth token already once generated.

The downsides to using Webhooks are that...

1. they are Room (Space) specific, so you need a unique Webhook per Space you'd like to post messages to, and...
2. they only allow posting messages into Hangouts Chat

Some additional functionality has been added to allow storage of encrypted Webhooks in the PSGSuite config directly via dictionary/hashtable. This allows you to use the hash key in your scripts as $hook with Send-GSChatMessage -Webhook $hook so you don't expose the Webhook in your script itself.

SDK Notes

Going the SDK route requires a few more steps to get set up. You'll need to add the Chat API to your project and configure it, which includes specifying a bot endpoint that is either:

• Public API endpoint URL to send bot messages to
  • If using PSGSuite to handle the logic around message handling, this requires some additional routing logic in your infrastructure to enable
  • This would provide the only way to really respond back to messages sent to the bot directly with PSGSuite, assuming your API server is running PSGSuite itself and the POST to the API triggers the PowerShell backend
• Google Apps Script deployment ID
  • This would be the only truly free option, as G Suite users already have access to Apps Script and other Google Services like it
  • This could possibly use Google Sheets as a sort of message queue and log for the bot, with a local instance of PSGSuite running in a loop and polling the Sheet for new messages every few seconds. I will be building a POC of this approach and adding to the documentation of it works as expected.
• a Google Cloud Pub/Sub endpoint
  • Requires a Google Cloud Platform subscription
  • Requires additional logic to poll the Pub/Sub endpoint that is not yet built out in PSGSuite
  • Can be costly if you aren't careful with your polling settings, as each request counts, even if it there aren't any new messages to grab from the queue

[scrthq]

added in v2.12.0