Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package GroupDocs.Translation-Cloud

System Requirements

GroupDocs.Translation Cloud is an on-demand service, meaning it has no specific device or OS requirements. It can be accessed using any programming language that supports HTTPS requests.

Note: GroupDocs.Translation Cloud works across all devices and operating systems, as long as they support HTTPS and have internet access.

Getting Started

1. Sign Up and Account Setup

1. Create an Account: Go to GroupDocs Cloud API.

   • If you’re already registered, sign in with your credentials.
   • If not, click Don’t have an account? Sign Up and follow the steps.

2. Subscription Plans: Review subscription plans and free-tier limits.

3. Privacy & Security: GroupDocs values your privacy. Refer to our Privacy Policy and Terms of Service for more information.

2. Get an Access Token

GroupDocs uses JWT authentication for secure data transfer. To get your access token:

1. Obtain Client ID and Secret:

   • Sign in to the GroupDocs Cloud API Dashboard.
   • Navigate to Applications, create storage for your files, provide an application name (e.g., HelloWorld), and copy the Client ID and Client Secret.

2. Request Access Token: Use the following cURL command:

   curl --location --request POST 'https://id.groupdocs.cloud/connect/token' \
     --data-urlencode 'grant_type=client_credentials' \
     --data-urlencode 'client_id=CLIENT-ID-VALUE' \
     --data-urlencode 'client_secret=CLIENT-SECRET-VALUE'
   

   The response will include your access token:

   {
      "access_token": "YOUR_ACCESS_TOKEN",
      "expires_in": 3600,
      "token_type": "Bearer"
   }
   

3. Translate Text Using GroupDocs.Translation API

Now that you have your access token, follow these steps to translate text:

1. Send Text for Translation: Use the cURL command to send a translation request from English to German:

   curl --location --request POST 'https://api.groupdocs.cloud/v2.0/translation/text' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --data '{
      "sourceLanguage": "en",
      "targetLanguages": ["de"],
      "texts": ["Hello, world! I can read this text in my language."]
   }'
   

   You will receive a unique request ID:

   {
      "status": 202,
      "message": "Starting translation",
      "id": "cb87bd7c-4660-4044-88c7-2b30edb44a4d"
   }
   

2. Retrieve Translated Text: Use the unique request ID to fetch the translated text:

   curl --location 'https://api.groupdocs.cloud/v2.0/translation/text/cb87bd7c-4660-4044-88c7-2b30edb44a4d' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
   

   The translated text will be returned:

   {
      "status": 200,
      "message": "Text translated successfully",
      "translations": {
         "de": ["Hallo, Welt! Ich kann diesen Text in meiner Sprache lesen."]
      }
   }
   

All URIs are relative to https://api.groupdocs.cloud/v2.0/translation

Documentation for Models

CloudFileResponse, CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData

GroupDocs.Translation Cloud SKDs

GitHub

Package Manager