DocumentaçãoAEM GuidesDocumentação do AEM Guides

Criar projeto de tradução

Last update: Tue Feb 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Desenvolvedor

Um método POST que ajuda a criar um projeto de tradução aceitando os detalhes necessários do projeto.

URL de solicitação

http://<aem-guides-server>:<port-number>/bin/guides/v1/translation/project/create

Tipo de solicitação

POST

Parâmetros de solicitação

Nome
Tipo
Descrição
type
String
newTranslationProject, xliffTranslationProject, newMultiLingualTranslationProject, addToExistingProject, newScopingTranslationProject
versionDetails, versionSelector
String
Linha de base, latestVersion, versionAsOfDate
language
String
Idiomas separados por vírgulas "de", "fr"
map.id
String
GUID do mapa de origem a ser traduzido
map.path
String
Caminho do mapa de origem a ser traduzido
referenceType
String
Indireto, Direto
fileType
String
Mapa, Tópico, Outros
documentState
String
pode ser uma das listas atribuídas pelo usuário no perfil do mapa
translationStatus
String
Fora de sincronia, Em sincronia, Atualizado, Desatualizado, Em andamento, Cópia ausente, NENHUM, N/D
NOTE
Você pode usar map.id ou map.path ao criar um projeto de tradução.

Exemplo de solicitação

{
  "title": "Test Project 1 on Dec 5",
  "type": "newTranslationProject",
  "translationDetails": {
    "map": {
      "id": "GUID-06527014-062d-46dc-8fea-48b4b4497c51-en",
      "path": "/content/dam/ajay-test/lang/en/m2.ditamap"
    },
    "languages": ["de"],
    "versionDetails": {
      "versionSelector": "latestVersion"
    }
  },
  "filterDetails": [
    { "name": "referenceType", "values": [] },
    { "name": "fileType", "values": [] },
    { "name": "documentState", "values": [] },
    { "name": "translationStatus", "values": [] }
   ]

Valores de resposta

{
  "executionId": "5c13c571-3407-46d5-8f45-50ea9e05a212",
  "path": "/content/projects/test_project_1_ondec5"
}

Códigos de resposta

  • 200 Êxito
  • Entrada 400 inválida
  • 401 Acesso não autorizado
  • Erro interno do servidor 500

Solicitações de exemplo

Adicionar a um projeto existente

{
  "title": "Add to existing Project",
  "type": "addToExistingProject",
  "path": "/content/projects/test_project_1_existing",
  "translationDetails": {
    "map": {
      "id": "GUID-06527014-062d-46dc-8fea-48b4b4497c51-en"
    },
    "languages": ["de"],
    "versionDetails": {
      "versionSelector": "versionAsOfDate",
      "version": "2025-12-05T10:30:00+01:30"
    }
  },
  "filterDetails": [
    { "name": "referenceType", "values": [] },
    { "name": "fileType", "values": [] },
    { "name": "documentState", "values": [] },
    { "name": "translationStatus", "values": [] }
  ]
}

Adicionar a um projeto existente com Linha de Base

{
  "title": "Add to existin project Project with baseline",
  "type": "addToExistingProject",
  "path": "/content/projects/existing_project_path",
  "translationDetails": {
    "map": {
      "id": "GUID-06527014-062d-46dc-8fea-48b4b4497c51-en"
    },
    "languages": ["de"],
    "versionDetails": {
      "versionSelector": "baseline",
      "version": "test1"
    }
  },
  "filterDetails": [
    { "name": "referenceType", "values": ["Direct"] },
    { "name": "fileType", "values": [] },
    { "name": "documentState", "values": [] },
    { "name": "translationStatus", "values": [] }
  ]
}

Status de criação do projeto de tradução

Uma API do GET que rastreia o status de tradução de um projeto de tradução recém-criado.

URL de solicitação

http://<aem-guides-server>:<port-number>/bin/guides/v1/translation/project/creationstatus

Tipo de solicitação

GET

Parâmetros de solicitação

Nome
Tipo
Descrição
path
String
Caminho do projeto
languageStatusMap
String
Para cada idioma solicitado, retorna o status de conclusão: Em andamento, Concluído, Com falha, Ignorado

Exemplo de solicitação

{
  "path": "/content/projects/test_project_1_ondec5",
  "languageStatusMap": {
    "de": "Completed"
  }
}
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178