Method: projects.detectLanguage

Detects the language of text within a request.

HTTP request

POST https://translate.googleapis.com/v3/{parent=projects/*}:detectLanguage

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Project or location to make a call. Must refer to a caller's project.

Format:projects/{project-number-or-id}/locations/{location-id} orprojects/{project-number-or-id}.

For global calls, useprojects/{project-number-or-id}/locations/global orprojects/{project-number-or-id}.

Only models within the same region (has same location-id) can be used. Otherwise an INVALID_ARGUMENT (400) error is returned.

Request body

The request body contains data with the following structure:

JSON representation
{"model":string,"mimeType":string,"labels":{string:string,...},// Union fieldsource can be only one of the following:"content":string// End of list of possible types for union fieldsource.}
Fields
model

string

Optional. The language detection model to be used.

Format:projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}

Only one language detection model is currently supported:projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default.

If not specified, the default model is used.

Authorization requires the followingIAM permission on the specified resourcemodel:

  • cloudtranslate.languageDetectionModels.predict
mimeType

string

Optional. The format of the source text, for example, "text/html", "text/plain". If left blank, the MIME type defaults to "text/html".

labels

map (key: string, value: string)

Optional. The labels with user-defined metadata for the request.

Label keys and values can be no longer than 63 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.

Seehttps://cloud.google.com/translate/docs/advanced/labels for more information.

Union fieldsource. Required. The source of the document from which to detect the language.source can be only one of the following:
content

string

The content of the input stored as a string.

Response body

If successful, the response body contains an instance ofDetectLanguageResponse.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-translation

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-04-30 UTC.