GT ClassMethodsTranslation

getProjectData

Référence de l’API pour la méthode getProjectData permettant de récupérer les informations et la configuration du projet

Vue d’ensemble

La méthode getProjectData récupère des informations détaillées sur un projet de traduction, notamment son nom, son organisation, sa locale par défaut et les locales cibles actuellement configurées. Cette méthode est utile pour comprendre la configuration du projet et valider ses paramètres.

const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });

const projectData = await gt.getProjectData('project-123');
console.log(`Projet : ${projectData.name}`);
console.log(`Locale par défaut : ${projectData.defaultLocale}`);
console.log(`Locales cibles : ${projectData.currentLocales.join(', ')}`);

Références

Paramètres

NomTypeDescription
projectIdstringL’identifiant unique du projet à récupérer
options?{ timeout?: number }Configuration facultative de la requête

Options

NomTypeDescription
timeout?numberDélai d’attente de la requête, en millisecondes

Renvoie

Promise<ProjectData> - Contient les informations et la configuration du projet.

type ProjectData = {
  id: string;
  name: string;
  orgId: string;
  defaultLocale: string;
  currentLocales: string[];
}
PropriétéTypeDescription
idstringIdentifiant unique du projet
namestringNom de projet lisible par l’humain
orgIdstringIdentifiant de l’organisation propriétaire du projet
defaultLocalestringLocale source par défaut du projet
currentLocalesstring[]Tableau des locales cibles actuellement configurées

Exemples

Utilisation de base

index.ts
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});

async function getProjectInfo(projectId: string) {
  try {
    const project = await gt.getProjectData(projectId);
    
    console.log('=== Informations du projet ===');
    console.log(`ID : ${project.id}`);
    console.log(`Nom : ${project.name}`);
    console.log(`Organisation : ${project.orgId}`);
    console.log(`Locale par défaut : ${project.defaultLocale}`);
    console.log(`Locales cibles : ${project.currentLocales.join(', ')}`);
    
    return project;
  } catch (error) {
    console.error(`Impossible de récupérer le projet ${projectId} :`, error);
    throw error;
  }
}

const projectInfo = await getProjectInfo('my-project-123');

Notes

  • La méthode offre un accès en lecture seule aux informations du projet — utilisez le tableau de bord pour modifier les paramètres du projet
  • Cette méthode nécessite un ID de projet valide — le projet doit être accessible avec la clé d’API fournie
  • Les données du projet incluent les configurations de locales source et cibles
  • Le tableau currentLocales répertorie toutes les locales cibles configurées pour le projet
  • Utilisez cette méthode pour valider la configuration du projet avant de lancer les workflows de traduction

Prochaines étapes

  • Consultez shouldSetupProject pour vérifier si une configuration du projet est nécessaire
  • Consultez setupProject pour initialiser la configuration du projet
  • Consultez enqueueFiles pour lancer les tâches de traduction
  • Consultez querySourceFile pour obtenir des informations spécifiques au fichier

Comment trouvez-vous ce guide ?