Enhance Your App with Google Translator Cognitive Actions

22 Apr 2025
Enhance Your App with Google Translator Cognitive Actions

The Google Translator Cognitive Actions allow developers to leverage Google’s powerful multilingual neural machine translation service to integrate language detection and translation capabilities into their applications. This suite of pre-built actions simplifies the process of adding language support, enabling developers to enhance user experiences across diverse linguistic backgrounds. In this article, we will explore two key actions: Detect Language and List Supported Translation Languages.

Prerequisites

Before you can start using the Google Translator Cognitive Actions, ensure you have the following:

  • An API key for the Google Cognitive Actions platform, which will authenticate your requests.
  • Basic knowledge of making HTTP requests and handling JSON data.

Authentication usually involves passing your API key in the request headers, allowing you to securely access the Cognitive Actions services.

Cognitive Actions Overview

Detect Language

Purpose: This action detects the language of a given text input using Google’s advanced machine translation capabilities. It is useful for applications that need to determine the language of user input dynamically.

  • Category: Language Detection

Input:

  • Required Field:
    • query: A string representing the text input you want to analyze (e.g., "Ce mai faci?").

Example Input:

{
  "query": "Ce mai faci?"
}

Output: The action returns the detected language along with a confidence score and reliability status. Here’s what a typical response looks like:

{
  "data": {
    "detections": [
      [
        {
          "language": "ro",
          "confidence": 1,
          "isReliable": false
        }
      ]
    ]
  }
}

Conceptual Usage Example (Python):

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "b63cc2bc-ce09-4aef-9c3c-73f630646de1" # Action ID for Detect Language

# Construct the input payload based on the action's requirements
payload = {
    "query": "Ce mai faci?"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, the action ID for Detect Language is specified, and the input payload is structured to include the query string. The endpoint URL and request format are illustrative.

List Supported Translation Languages

Purpose: This action retrieves a comprehensive list of languages supported for translation. This is particularly useful for applications that allow users to select their source and target languages.

  • Category: Language Translation

Input:

  • This action does not require any specific input fields.

Example Input:

{}

Output: The action returns a list of supported languages. An example response might look like this:

{
  "data": {
    "languages": [
      {"language": "ab"},
      {"language": "ace"},
      {"language": "ach"},
      // More languages...
      {"language": "zh"},
      {"language": "zh-CN"},
      {"language": "zh-TW"},
      {"language": "zu"}
    ]
  }
}

Conceptual Usage Example (Python):

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "c19aa261-cae6-4124-9e2b-8dc276bdda93" # Action ID for List Supported Translation Languages

# Construct the input payload based on the action's requirements
payload = {}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this example, the action ID for List Supported Translation Languages is used, and an empty payload is sent as no input is required.

Conclusion

Integrating Google Translator Cognitive Actions into your applications can greatly enhance their functionality by providing seamless language detection and translation capabilities. With just a few API calls, you can create a more inclusive and user-friendly experience for your audience. Next steps could include implementing additional translation features or combining these actions with your existing application logic to further enhance user interactions. Happy coding!

← Back to All Articles