Stay organized with collections
Save and categorize content based on your preferences.
This page documents production updates to Natural Language. We recommend
that Natural Language developers periodically check this list for any
new announcements. Major changes will also be announced via the
cloud-nl-discuss
mailing list.
You can see the latest product updates for all of Google Cloud on the
Google Cloud page, browse and filter all release notes in the
Google Cloud console,
or programmatically access release notes in
BigQuery.
To get the latest product updates delivered to you, add the URL of this page to your
feed
reader, or add the
feed URL directly.
August 28, 2023
The Natural Language API v2 is now available in Public Preview. This new version of the API supports Sentiment Analysis, Entity Analysis, Text Moderation, and Content Classification. This version has major updates for Sentiment Analysis and Entity Analysis, which include performance upgrades and general improvements. All API calls now return language_code .
Sentiment analysis uses a new PaLM-based model for improved quality. The language field is now called language_code.
Entity analysis uses a new PaLM-based model for improved quality. Please note the following updates:
language field is now called "language_code"
No salience field.
No wikipedia_url as metadata.
Parsing improvements for the following entity types: PHONE_NUMBER, ADDRESS, DATE, NUMBER, PRICE
New probability score field is returned for all entities where NUMBER, PHONE_NUMBER, ADDRESS, PRICE, DATE will always be 1.0.
January 31, 2023
Natural Language Content Classification v2 model is now Generally Available. This model supports an expanded taxonomy with 1091 content categories and 11 languages. The model is distilled from a Large Language Model with improved performance over the v1 offering.
October 18, 2022
Natural Language Content Classification v2 model is now in Public Preview. This model supports an expanded taxonomy with 1091 content categories and 11 languages. The model is distilled from a Large Language Model with improved performance over the v1 offering.
March 20, 2020
The Natural Language API now supports additional languages for sentiment analysis.
February 20, 2020
The Natural Language API now offers two multiregion endpoints (us-language.googleapis.com and eu-language.googleapis.com).
Using a multiregion endpoint enables you to configure the Natural Language API to
store and perform machine learning on your data in the United States or European Union.
May 03, 2019
The Natural Language API now supports Spanish for entity sentiment analysis.
April 04, 2019
The Natural Language API now supports Russian for entity analysis and syntactic analysis, and Japanese for entity sentiment analysis.
The analyzeEntities method identifies and returns additional entity types: phone numbers, addresses, dates, prices, and numbers.
November 16, 2017
Cloud Natural Language API version 1.2 GA release.
The Natural Language API has released the new classifyText method that analyzes text content and returns a content category for the content. For more information, see Content Classification.
September 19, 2017
The Natural Language API v1 now supports entity sentiment analysis with the analyzeEntitySentiment method. Entity sentiment analysis is currently only available for the English language. For more information, see Entity Sentiment Analysis.
The Natural Language API v1beta2 has added beta support for a new classifyText method that analyzes text content and returns a content category for the content. For more information, see Content Classification.
August 04, 2017
The following languages are now fully supported for entity, sentiment, and syntax analysis:
* Chinese (Simplified and Traditional)
* French
* German
* Italian
* Korean
* Portuguese
Sentiment analysis has been updated. You might see minor differences in score and magnitude from the same request made to previous releases.
Entity analysis has been updated. You might see minor differences in metadata (Wikipedia URLs, knowledge graph MIDs) of entities identified in a block of text from the same request made to the previous releases.
May 02, 2017
Cloud Natural Language API v1beta2 release. Added beta support for entity, sentiment, and syntax analysis for the following languages:
* Chinese (Simplified and Traditional)
* French
* German
* Italian
* Korean
* Portuguese
Added beta support for entity sentiment analysis (analyzeEntitySentiment). Entity sentiment analysis is currently only available for the English language. For more information, see Entity Sentiment Analysis.
The v1beta2 release includes updated document sentiment analysis. You might see differing results from the same request made to the Natural Language API v1 and v1beta2 releases.
The v1beta2 release includes updated entity analysis. You might see minor differences in metadata (Wikipedia URLs, knowledge graph MIDs) from the same request made to the Natural Language API v1 and v1beta2 releases.
The Natural Language API v1beta1 release has been deprecated.
November 15, 2016
Promoted the Cloud Natural Language API from Beta (v1beta1) to General Availability (v1).
Updates for v1 from the previous v1beta1 API endpoint include the features listed below.
The sentiment analysis feature has these enhancements:
* Support for Japanese (ja) and Spanish (es)
* Availability of sentence level sentiment
* Support for EncodingType within a Sentiment Analysis request to calculate offsets for sentence-level sentiment
*Addition of a score field within the Sentiment type to replace the previous polarity field
The entity analysis feature has these enhancements:
* Added Google Knowledge Graph MID values, if available, to the metadata field for each Entity returned
* Returns Entity Mention Types for both proper nouns and common nouns (known as "nominals")
Syntactic analysis has these enhancements:
* Added a new analyzeSyntax method
* Added morphology support to returned tokens
Removed the polarity field within the Sentiment type in favor of the new score field.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Natural Language release notes\n\nThis page documents production updates to Natural Language. We recommend\nthat Natural Language developers periodically check this list for any\nnew announcements. Major changes will also be announced via the\n[cloud-nl-discuss](https://groups.google.com/forum/#!forum/cloud-nl-discuss)\nmailing list.\n\nYou can see the latest product updates for all of Google Cloud on the\n[Google Cloud](/release-notes) page, browse and filter all release notes in the\n[Google Cloud console](https://console.cloud.google.com/release-notes),\nor programmatically access release notes in\n[BigQuery](https://console.cloud.google.com/bigquery?p=bigquery-public-data&d=google_cloud_release_notes&t=release_notes&page=table).\n\nTo get the latest product updates delivered to you, add the URL of this page to your\n[feed\nreader](https://wikipedia.org/wiki/Comparison_of_feed_aggregators), or add the\n[feed URL](https://cloud.google.com/feeds/language-release-notes.xml) directly.\n\nAugust 28, 2023\n---------------\n\nThe Natural Language API v2 is now available in [Public Preview](https://cloud.google.com/products#product-launch-stages). This new version of the API supports Sentiment Analysis, Entity Analysis, Text Moderation, and Content Classification. This version has major updates for Sentiment Analysis and Entity Analysis, which include performance upgrades and general improvements. All API calls now return `language_code` . \nSentiment analysis uses a new PaLM-based model for improved quality. The `language` field is now called `language_code`. \nEntity analysis uses a new PaLM-based model for improved quality. Please note the following updates:\n\n- **language** field is now called \"language_code\"\n- No **salience** field.\n- No **wikipedia_url** as metadata.\n- Parsing improvements for the following entity types: PHONE_NUMBER, ADDRESS, DATE, NUMBER, PRICE\n- New **probability** score field is returned for all entities where NUMBER, PHONE_NUMBER, ADDRESS, PRICE, DATE will always be 1.0.\n\nJanuary 31, 2023\n----------------\n\nNatural Language Content Classification v2 model is now [Generally Available](https://cloud.google.com/products#product-launch-stages). This model supports an expanded taxonomy with 1091 content categories and 11 languages. The model is distilled from a Large Language Model with improved performance over the v1 offering.\n\nOctober 18, 2022\n----------------\n\nNatural Language Content Classification v2 model is now in Public [Preview](https://cloud.google.com/products#product-launch-stages). This model supports an expanded taxonomy with 1091 content categories and 11 languages. The model is distilled from a Large Language Model with improved performance over the v1 offering.\n\nMarch 20, 2020\n--------------\n\nThe Natural Language API now supports [additional languages](https://cloud.google.com/natural-language/docs/languages#sentiment_analysis) for sentiment analysis.\n\nFebruary 20, 2020\n-----------------\n\nThe Natural Language API now offers two [multiregion endpoints](https://cloud.google.com/natural-language/docs/locations) (`us-language.googleapis.com` and `eu-language.googleapis.com`).\nUsing a multiregion endpoint enables you to configure the Natural Language API to\nstore and perform machine learning on your data in the United States or European Union.\n\nMay 03, 2019\n------------\n\nThe Natural Language API now supports [Spanish](https://cloud.google.com/natural-language/docs/languages) for entity sentiment analysis.\n\nApril 04, 2019\n--------------\n\nThe Natural Language API now supports [Russian](https://cloud.google.com/natural-language/docs/languages) for entity analysis and syntactic analysis, and Japanese for entity sentiment analysis. \nThe `analyzeEntities` method identifies and returns [additional entity types](https://cloud.google.com/natural-language/docs/reference/rest/v1/Entity#Type): phone numbers, addresses, dates, prices, and numbers.\n\nNovember 16, 2017\n-----------------\n\nCloud Natural Language API version 1.2 GA release. \nThe Natural Language API has released the new `classifyText` method that analyzes text content and returns a content category for the content. For more information, see [Content Classification](https://cloud.google.com/natural-language/docs/basics#content-classification).\n\nSeptember 19, 2017\n------------------\n\nThe Natural Language API `v1` now supports entity sentiment analysis with the `analyzeEntitySentiment` method. Entity sentiment analysis is currently only available for the English language. For more information, see [Entity Sentiment Analysis](https://cloud.google.com/natural-language/docs/basics#entity-sentiment-analysis). \nThe Natural Language API `v1beta2` has added beta support for a new `classifyText` method that analyzes text content and returns a content category for the content. For more information, see [Content Classification](https://cloud.google.com/natural-language/docs/basics#content-classification).\n\nAugust 04, 2017\n---------------\n\nThe following languages are now fully supported for entity, sentiment, and syntax analysis:\n\\* Chinese (Simplified and Traditional)\n\\* French\n\\* German\n\\* Italian\n\\* Korean\n\\* Portuguese \nSentiment analysis has been updated. You might see minor differences in score and magnitude from the same request made to previous releases. \nEntity analysis has been updated. You might see minor differences in metadata (Wikipedia URLs, knowledge graph MIDs) of entities identified in a block of text from the same request made to the previous releases.\n\nMay 02, 2017\n------------\n\nCloud Natural Language API `v1beta2` release. Added beta support for entity, sentiment, and syntax analysis for the following languages:\n\\* Chinese (Simplified and Traditional)\n\\* French\n\\* German\n\\* Italian\n\\* Korean\n\\* Portuguese \nAdded beta support for entity sentiment analysis (`analyzeEntitySentiment`). Entity sentiment analysis is currently only available for the English language. For more information, see [Entity Sentiment Analysis](https://cloud.google.com/natural-language/docs/basics#entity-sentiment-analysis). \nThe `v1beta2` release includes updated document sentiment analysis. You might see differing results from the same request made to the Natural Language API `v1` and `v1beta2` releases. \nThe `v1beta2` release includes updated entity analysis. You might see minor differences in metadata (Wikipedia URLs, knowledge graph MIDs) from the same request made to the Natural Language API `v1` and `v1beta2` releases. \nThe Natural Language API `v1beta1` release has been deprecated.\n\nNovember 15, 2016\n-----------------\n\nPromoted the Cloud Natural Language API from Beta (v1beta1) to General Availability (v1).\nUpdates for v1 from the previous v1beta1 API endpoint include the features listed below. \nThe sentiment analysis feature has these enhancements:\n\\* Support for Japanese (`ja`) and Spanish (`es`)\n\\* Availability of [sentence level sentiment](https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/analyzeSentiment#response-body)\n\\* Support for [EncodingType](https://cloud.google.com/natural-language/docs/reference/rest/v1/EncodingType) within a Sentiment Analysis request to calculate offsets for sentence-level sentiment\n\\*Addition of a `score` field within the [`Sentiment`](https://cloud.google.com/natural-language/docs/reference/rest/v1/Sentiment) type to replace the previous `polarity` field \nThe entity analysis feature has these enhancements:\n\\* Added Google Knowledge Graph MID values, if available, to the [`metadata` field for each `Entity`](https://cloud.google.com/natural-language/docs/reference/rest/v1/Entity) returned\n\\* Returns [Entity Mention Types](https://cloud.google.com/natural-language/docs/reference/rest/v1/Entity#type_1) for both proper nouns and common nouns (known as \"nominals\") \nSyntactic analysis has these enhancements:\n\\* Added a new [`analyzeSyntax`](https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/analyzeSyntax) method\n\\* Added morphology support to returned [tokens](https://cloud.google.com/natural-language/docs/reference/rest/v1/Token) \nRemoved the `polarity` field within the [`Sentiment`](https://cloud.google.com/natural-language/docs/reference/rest/v1/Sentiment) type in favor of the new `score` field."]]
