Console
    Contact Us Start free

    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 keyto 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 APIfrom the API list.

    4. Configure the applicable restrictions.

    5. Click Saveto 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 Languagesaction to list available languages in Google Translate.

    This action doesn't run on Google SecOps entities.

    Action inputs

    The List Languagesaction 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 Languagesaction 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 Languagesaction 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 Languagesaction:

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

    The List Languagesaction 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 Languagesaction:

    Script result name Value
    is_success True or False

    Ping

    Use the Pingaction to test the connectivity to Google Translate.

    This action doesn't run on Google SecOps entities.

    Action inputs

    None.

    Action outputs

    The Pingaction 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 Pingaction 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 Pingaction:

    Script result name Value
    is_success True or False

    Translate Text

    Use the Translate Textaction to translate text with Google Translate.

    This action doesn't run on Google SecOps entities.

    Action inputs

    The Translate Textaction 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 Textaction 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 Textaction:

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

    The Translate Textaction 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 Textaction:

    Script result name Value
    is_success True or False

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

    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: