Integrate Google Translate with Google SecOps

This document explains how to configure and integrate Google Translate with Google Security Operations (Google SecOps).

Integration version: 4.0

Before you begin

To use the integration, you need to create and configure an API key.

Create the API key

To create the API key, complete the following steps:

  1. In the Google Cloud console, go to APIs & Services > Credentials.

    Go to Credentials

  2. Click add Create credentials.

  3. Select API key to generate a new API key. A dialog appears with a generated API key.

  4. To copy the API key, click Copy.

Configure the API key restrictions

To configure the API restriction for the API key, complete the following steps:

  1. Click Restrict key.

  2. Under API restrictions, select Restrict key.

  3. Select Cloud Translation API from the API list.

  4. Configure the applicable restrictions.

  5. Click Save to save the API key configuration.

Integration parameters

The Google Translate integration requires the following parameters:

Parameter Description
API Root

Required.

The API root of the Google Translate instance.

The default value is https://translation.googleapis.com.

For more information about Cloud Translation API, see Cloud Translation API.
API Key

Required.

The API key of the Google Translate account.
Verify SSL

Required.

If selected, the integration validates the SSL certificate when connecting to the Google Translate server.

Selected by default.

For instructions about how to configure an integration in Google SecOps, see Configure integrations.

You can make changes at a later stage, if needed. After you configure an integration instance, you can use it in playbooks. For more information about how to configure and support multiple instances, see Supporting multiple instances.

Actions

For more information about actions, see Respond to pending actions from Your Workdesk and Perform a manual action.

List Languages

Use the List Languages action to list available languages in Google Translate.

This action doesn't run on Google SecOps entities.

Action inputs

The List Languages action requires the following parameters:

Parameter Description
Filter Key

Optional.

A key to filter languages.

The possible values are as follows:

  • Select One
  • Name

The default value is Select One.
Filter Logic

Optional.

A filter logic to apply.

The filtering logic uses the value that you set in the Filter Key parameter.

The possible values are as follows:

  • Not Specified
  • Equal
  • Contains

The default value is Not Specified.
Filter Value

Optional.

A value to use in the filter.

The filtering logic uses the value that you set in the Filter Key parameter.

If Equal is selected, the action searches for the exact match among results. If Contains is selected, the action searches for results that contain the specified substring.

If you don't select a value, the action ignores the filter.

Filtering logic is working based on the value provided in the Filter Key parameter.
Max Records To Return

Optional.

The maximum number of records to return.

The maximum value is 50.

If you don't set a value, the action returns 50 records by default.

Action outputs

The List Languages action provides the following outputs:

Action output type Availability
Case wall attachment Not available
Case wall link Not available
Case wall table Available
Enrichment table Not available
JSON result Available
Output messages Available
Script result Available
Case wall table

The List Languages action can generate the following table:

Table name: Available Languages

Table column: Language Key

JSON result

The following example shows the JSON result output received when using the List Languages action:

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
Output messages

The List Languages action can return the following output messages:

Output message Message description

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

The filter was not applied, because parameter "Filter Value" has an empty value.

 The action succeeded.
Error executing action "List Languages". Reason: ERROR_REASON

The action failed.

Check the connection to the server, input parameters, or credentials.
Script result

The following table lists the value for the script result output when using the List Languages action:

Script result name Value
is_success True or False

Ping

Use the Ping action to test the connectivity to Google Translate.

This action doesn't run on Google SecOps entities.

Action inputs

None.

Action outputs

The Ping action provides the following outputs:

Action output type Availability
Case wall attachment Not available
Case wall link Not available
Case wall table Not available
Enrichment table Not available
JSON result Not available
Output messages Available
Script result Available
Output messages

The Ping action can return the following output messages:

Output message Message description

Successfully connected to the Google Translate server with the provided connection parameters!

 The action succeeded.
Failed to connect to the Google Translate server! Error is ERROR_REASON

The action failed.

Check the connection to the server, input parameters, or credentials.
Script result

The following table lists the value for the script result output when using the Ping action:

Script result name Value
is_success True or False

Translate Text

Use the Translate Text action to translate text with Google Translate.

This action doesn't run on Google SecOps entities.

Action inputs

The Translate Text action requires the following parameters:

Parameter Description
Source Language

Optional.

A source language of the text.

If you don't configure this parameter, the action detects the language automatically.
Target Language

Required.

A target language.

The default value is en.
Text

Required.

A text to translate.

Action outputs

The Translate Text action provides the following outputs:

Action output type Availability
Case wall attachment Not available
Case wall link Not available
Case wall table Not available
Enrichment table Not available
JSON result Available
Output messages Available
Script result Available
JSON result

The following example shows the JSON result output received when using the Translate Text action:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
Output messages

The Translate Text action can return the following output messages:

Output message Message description

Successfully translated the provided text in Google Translate.

 The action succeeded.
Error executing action "Translate Text". Reason: ERROR_REASON

The action failed.

Check the connection to the server, input parameters, or credentials.
Script result

The following table lists the value for the script result output when using the Translate Text action:

Script result name Value
is_success True or False

Need more help? Get answers from Community members and Google SecOps professionals.