.JSON - Phrase Strings

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Extensões de arquivo	.json
Extensão de API	strings_json
Importar	Sim
Exportar	Sim
Suporte para formas plurais	Sim
Suporte para descrição	Sim
Suporte a estado	Sim
Suporte a metadados	Sim
Opções de formato	ignore_translation_state export_translation_state export_description export_tags export_system_tags export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

O formato JSON de Phrase Strings fornece uma maneira estruturada de armazenar e gerenciar traduções, incorporando metadados, rastreamento de estado e integração de fluxo de trabalho para funcionalidade aprimorada.

Este formato inclui metadados como detalhes de localização, limites de caractere, descrições, tipo de forma plural e estados de tradução. O recurso de suporte a estado permite um melhor rastreamento do progresso da tradução e integração com fluxos de trabalho automatizados.

Definições de campo

Objeto de chave

O objeto de chave contém metadados e configurações para cada chave de tradução.

Campo	Obrigatório	Tipo	Descrição
`nome`	Sim	String	Identificador exclusivo para a chave.
`description`	Não	String	Uma breve explicação do propósito da chave.
`plural`	Não	Booleano	Especifica se a chave oferece suporte a pluralização.
`use_ordinal_rules`	Não	Booleano	Indica se as formas plurais da chave são ordinais. O padrão é `false` se omitido. Usado durante a importação e exportação.
`max_characters_allowed`	Não	Inteiro/Nulo	Número máximo de caracteres permitidos. `null` significa que não há limite.
`tags`	Não	Matriz	Categorização tags para filtragem e organização.
`metadata`	Não	Objeto	Armazena metadados adicionais como pares de chave-valor. Ele pode ser adicionado ou atualizado, mas não removido. Para remover metadados, defina seu valor como uma string vazia.

Objeto de Traduções

O objeto de traduções contém traduções localizadas para uma determinada chave.

Campo	Obrigatório	Tipo	Descrição
`local`	Sim	String	O nome ou identificador do locale conforme configurado em Projeto/Idiomas. Este valor determina a correspondência durante a importação. Se não houver uma correspondência exata com um nome de idioma existente, a tradução não será importada.
`locale_code`	Não	String	O código do idioma do locale (por exemplo, en-US, fr-FR).
`conteúdo`	Sim	String/Objeto	O conteúdo traduzido. Se pluralizado, um objeto que mapeia formas plurais com base na configuração `use_ordinal_rules` da chave.
`estado`	Não	String	O estado da tradução. Estados de tradução suportados: não traduzido não verificada traduzido revisado

Opções de formato

Identificador	ignore_translation_state
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	false
Descrição	Se verdadeiro, ignora valores de estado em traduções importadas, o que significa que o arquivo enviado não substituirá estados de tradução existentes.

Identificador	export_translation_state
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	true
Descrição	Inclui valores de estado em traduções exportadas; se definido como falso, as informações de estado serão omitidas do arquivo exportado.

Identificador	export_system_tags
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Se verdadeiro, exporta tags do sistema junto com chaves e traduções.

Identificador	export_tags
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Se verdadeiro, exporta tags junto com chaves e traduções.

Identificador	export_description
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	true
Descrição	Exporta a descrição da chave.

Identificador	export_max_characters_allowed
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	true
Descrição	Exporta o limite de caracteres da chave junto com chaves e traduções.

Identificador	custom_metadata_columns
Tipo	hash
Upload	Não
Download	Sim
Padrão	[Vazio]
Descrição	HashMap de valores de metadados personalizados que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados personalizados, conforme definido em Phrase Strings. Valor = Índice da coluna (1, 2, 3, etc.) onde a propriedade está no arquivo importado/onde a propriedade deve estar no arquivo exportado.

Identificador	export_use_ordinal_rules
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Se verdadeiro, o campo `use_ordinal_rules` é exibido no arquivo baixado. Se estiver baixando arquivos via a UI, utilize a opção correspondente Adicionar tipo plural para cada chave.

Amostra de código

{
  "welcome_message": {
    "key": {
      "description": "Mensagem exibida na tela de boas-vindas",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "Inglês (Estados Unidos)",
        "locale_code": "en-US",
        "content": "Bem-vindo ao nosso aplicativo!",
        "state": "reviewed"
      },
      {
        "locale": "Francês (França)",
        "locale_code": "fr-FR",
        "content": "Bienvenue dans notre application !",
        "state": "translated"
      }
    ]
  }
}

Formas plurais

Este formato usa categorias nomeadas para identificar as várias pluralizações de uma chave. As seguintes categorias são reservadas para formas plurais:

.zero | .one | .two | .few | .many | .other

Nomes de exemplos de chaves pluralizadas identificadas, persistentes e marcadas corretamente:

inbox.messages.notification.one
inbox.messages.notification.other

O uso da forma plural é configurado através do campo use_ordinal_rules. Se use_ordinal_rules for falso ou não definido, as regras de pluralização cardinais serão aplicadas.

Exemplo de Entrada

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1º lugar",
      "two": "2º lugar",
      "few": "3º lugar",
      "other": "%dº lugar"
    }
  }