Contents x
    Google Workspace - Send Direct Message to a User
    • 30 Dec 2024
    • 2 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Contents

    Google Workspace - Send Direct Message to a User

    • Updated on 30 Dec 2024
    • 2 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Article summary

    Google Workspace - Send Message to a User posts a message to a Google Workspace user for:

    • Assets returned by the selected query or assets selected on the relevant asset page.

    See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

    Note:

    Required Fields

    These fields must be configured to run the Enforcement Set.

    • Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
    • Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

    • Use stored credentials from Google Workspace (G Suite) Adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.

      • When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
      Note:

      To use this option, you must successfully configure a Google Workspace (G Suite) adapter connection.

    • Space ID - The ID of the Google Workspace to which to send the message.

    • Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.

    Additional Fields

    • Chat Header (default: Axonius Action Center) - The header of the chat.
    • Chat Text - The text to send to the user.

    Connection and Credentials

    When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

    • Email of an admin account to impersonate - The email of your Google Workspace admin.
    • Account Profile Name - Google user name for retrieving SaaS data.
    • JSON Key pair for the service account - Upload the JSON file you have created for your service account. For more details, refer to Google Workspace adapter.
    • Gateway Name - Select the Gateway through which to connect to perform the action.

    API

    Axonius uses the Method: spaces.messages.create | Google Chat | Google for Developers API.

    Required Permissions

    The stored credentials, or those provided in Connection and Credentials, must have the following permission(s) to perform this Enforcement Action:

    • https://www.googleapis.com/auth/chat.messages.create
    • https://www.googleapis.com/auth/chat.admin.spaces

    For more details about other Enforcement Actions available, see Action Library.

    Was this article helpful?
    What's Next