Google

Cloud Translation API

Integrates text translation into your website or application.

AI & machine learning#openapi#analytics#media

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Integrates text translation into your website or application.

Endpoints 32

projects.locations

  • POSTDetects the language of text within a request./v3/:parent:detectLanguageDetects the language of text within a request.
  • GETReturns a list of supported languages for translation./v3/:parent/supportedLanguages?displayLanguageCode=string&model=stringReturns a list of supported languages for translation.
  • POSTRomanize input text written in non-Latin scripts to Latin text./v3/:parent:romanizeTextRomanize input text written in non-Latin scripts to Latin text.
  • POSTTranslates input text and returns translated text./v3/:parent:translateTextTranslates input text and returns translated text.
  • POSTTranslate text using Adaptive MT./v3/:parent:adaptiveMtTranslateTranslate text using Adaptive MT.
  • POSTTranslates a large volume of document in asynchronous batch mode/v3/:parent:batchTranslateDocumentTranslates a large volume of document in asynchronous batch mode. This function provides real-time output as the inputs are being processed. If caller cancels…
  • POSTTranslates a large volume of text in asynchronous batch mode/v3/:parent:batchTranslateTextTranslates a large volume of text in asynchronous batch mode. This function provides real-time output as the inputs are being processed. If caller cancels a…
  • GETLists information about the supported locations for this service/v3/:name/locations?extraLocationTypes=string&filter=string&pageSize=0&pageToken=stringLists information about the supported locations for this service. This method lists locations based on the resource scope provided in the…
  • POSTRefines the input translated text to improve the quality./v3/:parent:refineTextRefines the input translated text to improve the quality.
  • POSTTranslates documents in synchronous mode./v3/:parent:translateDocumentTranslates documents in synchronous mode.

projects.locations.operations

  • GETGets the latest state of a long-running operation/v3/:nameGets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
  • DELETEDeletes a long-running operation/v3/:nameDeletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If…
  • POSTStarts asynchronous cancellation on a long-running operation/v3/:name:cancelStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the…
  • GETLists operations that match the specified filter in the request/v3/:name/operations?filter=string&pageSize=0&pageToken=string&returnPartialSuccess=trueLists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.
  • POSTWaits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest…/v3/:name:waitWaits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done,…

projects.locations.glossaries.glossaryEntries

  • PATCHUpdates a glossary entry./v3/:nameUpdates a glossary entry.
  • GETList the entries for the glossary./v3/:parent/glossaryEntries?pageSize=0&pageToken=stringList the entries for the glossary.
  • POSTCreates a glossary entry./v3/:parent/glossaryEntriesCreates a glossary entry.

projects.locations.adaptiveMtDatasets

  • GETLists all Adaptive MT datasets for which the caller has read permission./v3/:parent/adaptiveMtDatasets?filter=string&pageSize=0&pageToken=stringLists all Adaptive MT datasets for which the caller has read permission.
  • POSTCreates an Adaptive MT dataset./v3/:parent/adaptiveMtDatasetsCreates an Adaptive MT dataset.
  • POSTImports an AdaptiveMtFile and adds all of its sentences into the AdaptiveMtDataset./v3/:parent:importAdaptiveMtFileImports an AdaptiveMtFile and adds all of its sentences into the AdaptiveMtDataset.

projects.locations.adaptiveMtDatasets.adaptiveMtFiles

  • GETLists all AdaptiveMtFiles associated to an AdaptiveMtDataset./v3/:parent/adaptiveMtFiles?pageSize=0&pageToken=stringLists all AdaptiveMtFiles associated to an AdaptiveMtDataset.

projects.locations.adaptiveMtDatasets.adaptiveMtSentences

  • GETLists all AdaptiveMtSentences under a given file/dataset./v3/:parent/adaptiveMtSentences?pageSize=0&pageToken=stringLists all AdaptiveMtSentences under a given file/dataset.

projects.locations.datasets

  • GETLists datasets./v3/:parent/datasets?pageSize=0&pageToken=stringLists datasets.
  • POSTCreates a Dataset./v3/:parent/datasetsCreates a Dataset.
  • POSTExports dataset's data to the provided output location./v3/:dataset:exportDataExports dataset's data to the provided output location.
  • POSTImport sentence pairs into translation Dataset./v3/:dataset:importDataImport sentence pairs into translation Dataset.

projects.locations.datasets.examples

  • GETLists sentence pairs in the dataset./v3/:parent/examples?filter=string&pageSize=0&pageToken=stringLists sentence pairs in the dataset.

projects.locations.glossaries

  • GETLists glossaries in a project/v3/:parent/glossaries?filter=string&pageSize=0&pageToken=stringLists glossaries in a project. Returns NOT_FOUND, if the project doesn't exist.
  • POSTCreates a glossary and returns the long-running operation/v3/:parent/glossariesCreates a glossary and returns the long-running operation. Returns NOT_FOUND, if the project doesn't exist.

projects.locations.models

  • GETLists models./v3/:parent/models?filter=string&pageSize=0&pageToken=stringLists models.
  • POSTCreates a Model./v3/:parent/modelsCreates a Model.

API details

Base URL
https://translation.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 2 scopes
An API key in the key query parameter
Operations
32 operations on 25 pathsPOST 18GET 12PATCH 1DELETE 1
Main resources
projects.locations 10projects.locations.operations 5projects.locations.datasets 4projects.locations.adaptiveMtDatasets 3projects.locations.glossaries.glossaryEntries 3projects.locations.glossaries 2projects.locations.models 2projects.locations.adaptiveMtDatasets.adaptiveMtFiles 1projects.locations.adaptiveMtDatasets.adaptiveMtSentences 1projects.locations.datasets.examples 1
Response formats
application/json
Description format
Google API Discovery, API version v3

How to test the Cloud Translation API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Cloud Translation API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Detects the language of text within a request.” (POST /v3/:parent:detectLanguage), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Cloud Translation API?

Integrates text translation into your website or application. It is listed under AI & machine learning and has 32 endpoints.

Who publishes the Cloud Translation API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Cloud Translation API?

Requests go to https://translation.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Cloud Translation API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 2 scopes; an API key in the key query parameter.

How many endpoints does the Cloud Translation API have?

32 operations on 25 paths (18 POST, 12 GET, 1 PATCH, 1 DELETE). The largest groups are projects.locations, projects.locations.operations, projects.locations.datasets, projects.locations.adaptiveMtDatasets.

Is forking the Cloud Translation API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.