Class Translations

Translators can work with entirely untranslated project or you can pre-translate the files to ease the translations process.

Use API to pre-translate files via Machine Translation (MT) or Translation Memory (TM), upload your existing translations, and download translations correspondingly. Pre-translate and build are asynchronous operations and shall be completed with sequence of API methods.

Hierarchy (view full)

CrowdinApi
- Translations

Constructors

constructor

new Translations(credentials, config?): Translations
Parameters
- credentials: Credentials
  credentials
- Optionalconfig: ClientConfig
  optional configuration of the client
Returns Translations
Inherited from CrowdinApi.constructor
- Defined in core/index.ts:228

Methods

buildProjectFileTranslation

buildProjectFileTranslation(projectId, fileId, request, eTag?): Promise<ResponseObject<BuildProjectFileTranslationResponse>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- request: BuildProjectFileTranslationRequest
  request body
- OptionaleTag: string
  'If-None-Match' header
Returns Promise<ResponseObject<BuildProjectFileTranslationResponse>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.files.post
- Defined in translations/index.ts:123

cancelBuild

cancelBuild(projectId, buildId): Promise<void>
Parameters
- projectId: number
  project identifier
- buildId: number
  build identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.delete
- Defined in translations/index.ts:241

checkBuildStatus

checkBuildStatus(projectId, buildId): Promise<ResponseObject<Build>>
Parameters
- projectId: number
  project identifier
- buildId: number
  build identifier
Returns Promise<ResponseObject<Build>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.get
- Defined in translations/index.ts:231

downloadTranslations

downloadTranslations(projectId, buildId): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- buildId: number
  build identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.download.download
- Defined in translations/index.ts:221

editPreTranslation

editPreTranslation(projectId, preTranslationId, request): Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- preTranslationId: string
  pre translation identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.pre-translations.patch
- Defined in translations/index.ts:65

editPreTranslations

editPreTranslations(projectId, request): Promise<ResponseList<Status<PreTranslationStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseList<Status<PreTranslationStatusAttributes>>>
See
https://developer.crowdin.com/api/v2/#tag/Translations/operation/api.projects.pre-translations.patchBatch
- Defined in translations/index.ts:79

exportProjectTranslation

exportProjectTranslation(projectId, request): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- request: ExportProjectTranslationRequest
  request body
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.exports.post
- Defined in translations/index.ts:251

getPreTranslationReport

getPreTranslationReport(projectId, preTranslationId): Promise<ResponseObject<PreTranslationReport>>
Parameters
- projectId: number
  project identifier
- preTranslationId: string
  pre translation identifier
Returns Promise<ResponseObject<PreTranslationReport>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.pre-translations.report.getReport
- Defined in translations/index.ts:92

graphql

graphql<T>(req, config?): Promise<ResponseObject<T>>
Type Parameters
- T
Parameters
- req: {
      operationName?: string;
      query: string;
      variables?: any;
  }
  - OptionaloperationName?: string
  - query: string
  - Optionalvariables?: any
- config: {
  url?: string;
  } = {}
  - Optionalurl?: string
Returns Promise<ResponseObject<T>>
Inherited from CrowdinApi.graphql
- Defined in core/index.ts:263

importTranslations

importTranslations(projectId, request): Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- request: ImportTranslationsRequest | ImportTranslationsStringsRequest
  request body
Returns Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>
See
https://support.crowdin.com/developer/api/v2/#tag/Translations/operation/api.projects.translations.imports
- Defined in translations/index.ts:264

importTranslationsReport

importTranslationsReport(projectId, importId): Promise<ResponseObject<ImportTranslationsReport | ImportTranslationsStringsReport>>
Parameters
- projectId: number
  project identifier
- importId: string
  import identifier
Returns Promise<ResponseObject<ImportTranslationsReport | ImportTranslationsStringsReport>>
See
https://support.crowdin.com/developer/api/v2/#tag/Translations/operation/api.projects.translations.imports.report.get
- Defined in translations/index.ts:304

importTranslationsStatus

importTranslationsStatus(projectId, importId): Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- importId: string
  import identifier
Returns Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>
See
https://support.crowdin.com/developer/api/v2/#tag/Translations/operation/api.projects.translations.imports.get
- Defined in translations/index.ts:284

listPreTranslations

listPreTranslations(projectId, options?): Promise<ResponseList<Status<PreTranslationStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: Partial<Pagination>
  optional parameters for the request
Returns Promise<ResponseList<Status<PreTranslationStatusAttributes>>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.pre-translations.getMany
- Defined in translations/index.ts:25

listProjectBuilds

listProjectBuilds(projectId, options?): Promise<ResponseList<Build>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: ListProjectBuildsOptions
  optional parameters for the request
Returns Promise<ResponseList<Build>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.getMany
- Defined in translations/index.ts:142
listProjectBuilds(projectId, branchId?, limit?, offset?): Promise<ResponseList<Build>>
Parameters
- projectId: number
  project identifier
- OptionalbranchId: number
  branch identifier
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
Returns Promise<ResponseList<Build>>
Deprecated
optional parameters should be passed through an object

See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.builds.getMany
- Defined in translations/index.ts:154

listTranslations

listTranslations(options): Promise<ResponseList<TranslationSearchResult>>
Parameters
- options: ListTranslationsOptions
  optional parameters for the request
Returns Promise<ResponseList<TranslationSearchResult>>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.translations.getMany
- Defined in translations/index.ts:318

preTranslationStatus

preTranslationStatus(projectId, preTranslationId): Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>
Parameters
- projectId: number
  project identifier
- preTranslationId: string
  pre translation identifier
Returns Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>
See
https://developer.crowdin.com/api/v2/#tag/Translations/paths/~1projects~1{projectId}~1pre-translations~1{preTranslationId}/get
- Defined in translations/index.ts:38

uploadTranslation

uploadTranslation(projectId, languageId, request): Promise<ResponseObject<UploadTranslationResponse>>
Parameters
- projectId: number
  project identifier
- languageId: string
  language identifier
- request: UploadTranslationRequest
  request body
Returns Promise<ResponseObject<UploadTranslationResponse>>
Deprecated
See
https://developer.crowdin.com/api/v2/#operation/api.projects.translations.postOnLanguage
- Defined in translations/index.ts:195

uploadTranslationStrings

uploadTranslationStrings(projectId, languageId, request): Promise<ResponseObject<UploadTranslationStringsResponse>>
Parameters
- projectId: number
- languageId: string
- request: UploadTranslationStringsRequest
Returns Promise<ResponseObject<UploadTranslationStringsResponse>>
Deprecated
- Defined in translations/index.ts:207

withFetchAll

withFetchAll(maxLimit?): this
Parameters
- OptionalmaxLimit: number
Returns this
Inherited from CrowdinApi.withFetchAll
- Defined in core/index.ts:325

Class Translations

Hierarchy (view full)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Translations

Methods

applyPreTranslation

Parameters

Returns Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>

See

buildProject

Parameters

Returns Promise<ResponseObject<Build>>

See

buildProjectDirectoryTranslation

Parameters

Returns Promise<ResponseObject<BuildProjectDirectoryTranslationResponse>>

See

buildProjectFileTranslation

Parameters

Returns Promise<ResponseObject<BuildProjectFileTranslationResponse>>

See

cancelBuild

Parameters

Returns Promise<void>

See

checkBuildStatus

Parameters

Returns Promise<ResponseObject<Build>>

See

downloadTranslations

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

editPreTranslation

Parameters

Returns Promise<ResponseObject<Status<PreTranslationStatusAttributes>>>

See

editPreTranslations

Parameters

Returns Promise<ResponseList<Status<PreTranslationStatusAttributes>>>

See

exportProjectTranslation

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

getPreTranslationReport

Parameters

Returns Promise<ResponseObject<PreTranslationReport>>

See

graphql

Type Parameters

Parameters

OptionaloperationName?: string

query: string

Optionalvariables?: any

Optionalurl?: string

Returns Promise<ResponseObject<T>>

importTranslations

Parameters

Returns Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>

See

importTranslationsReport

Parameters

Returns Promise<ResponseObject<ImportTranslationsReport | ImportTranslationsStringsReport>>

See

importTranslationsStatus

Parameters

Returns Promise<ResponseObject<Status<ImportTranslationsStatusAttributes | ImportTranslationsStringsStatusAttributes>>>

See

listPreTranslations

Parameters

Returns Promise<ResponseList<Status<PreTranslationStatusAttributes>>>

See

listProjectBuilds

Parameters

`Optional`operationName?: string

`Optional`variables?: any

`Optional`url?: string