Skip to main content

Text Analyze

Analyzes text using Google Cloud Natural Language API to extract insights such as sentiment, entities, and syntax.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Text - The text content to analyze.

Options​

  • Credentials - Google Cloud service account credentials used to authenticate with the Natural Language API.
  • Action - The type of analysis to perform. Options include:
    • Sentiment Analysis
    • Entity Analysis
    • Entity Sentiment Analysis
    • Syntactic Analysis
    • Content Classification

Output​

  • Result - The analysis results in structured format depending on the selected action.

How It Works​

The Text Analyze node processes text using Google Cloud Natural Language API to extract various types of insights. When executed, the node:

  1. Validates the provided text input
  2. Retrieves Google Cloud credentials from the credentials option
  3. Creates a Natural Language API client with the provided credentials
  4. Performs the selected type of analysis on the text:
    • Sentiment Analysis: Determines the emotional tone of the text (positive, negative, neutral)
    • Entity Analysis: Extracts entities (people, places, organizations, etc.) and their metadata
    • Entity Sentiment Analysis: Combines entity extraction with sentiment analysis for each entity
    • Syntactic Analysis: Analyzes the grammatical structure of the text
    • Content Classification: Classifies the content into categories
  5. Returns the structured analysis results

Requirements​

  • Valid Google Cloud service account credentials with Natural Language API access
  • Text content to analyze

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid text input
  • Invalid or missing Google Cloud credentials
  • Invalid analysis type selection
  • Google Cloud Natural Language API service errors
  • Network connectivity issues
  • Insufficient permissions for the service account

Usage Notes​

  • The credentials must be a valid Google Cloud service account JSON key
  • Different analysis types provide different insights:
    • Sentiment Analysis is useful for understanding opinions and emotions
    • Entity Analysis helps identify key people, places, and concepts
    • Entity Sentiment Analysis combines both to understand feelings toward specific entities
    • Syntactic Analysis is useful for understanding grammatical structure
    • Content Classification helps categorize documents
  • The node returns structured data that can be parsed for specific insights
  • Longer texts may require more processing time and API quota
  • The default analysis type is Sentiment Analysis
  • Results are returned in the language of the input text when possible