Passer de l'édition Basic à la version avancée

Les utilisateurs existants de Cloud Translation – Basic (v2) qui souhaitent utiliser les fonctionnalités de traduction les plus récentes, tels que les glossaires et les modèles AutoML, doivent migrer leur application vers Cloud Translation – Advanced (v3). Pour obtenir une comparaison, consultez la page Comparer les notions de base et avancées.

La migration vers l'édition avancée comprend l'utilisation de la gestion de l'authentification et des accès (IAM) et des bibliothèques clientes de l'édition avancée. Les sections suivantes décrivent les tâches de migration et les principales différences entre les deux éditions.

Migrer vers la version avancée

Les étapes suivantes décrivent les actions requises pour mettre à jour vos applications existantes de l'utilisation de Cloud Translation – Basic vers Cloud Translation – Advanced.

  1. Faites l'inventaire de vos projets, applications et utilisateurs Google Cloud ayant accès à l'API Cloud Translation – Basic. Vous devrez fournir des comptes de service et les mettre à jour pour utiliser les bibliothèques clientes Cloud Translation – Advanced.
  2. Configurez les comptes de service et l'authentification pour votre application.
  3. Utilisez les rôles IAM pour définir des autorisations sur les comptes de service.
  4. Activez Cloud Translation – Advanced pour votre projet. Si vous utilisez des modèles AutoML avec Cloud Translation – Advanced, vous devez également activer AutoML. Pour en savoir plus, consultez le guide de configuration.
  5. Utilisez les bibliothèques et méthodes clientes de Cloud Translation – Advanced. Pour les requêtes Cloud Translation – Advanced, vous devez inclure le numéro (ou l'ID) et l'emplacement du projet, par exemple global ou us-central1.
  6. Vérifiez que la taille de vos requêtes de traduction à Cloud Translation – Advanced ne dépasse pas la limite.
  7. Planifiez le suivi de votre quota de requêtes de traduction. Les deux versions de l'API sont soumises aux mêmes quotas quotidiens et mensuels.
  8. Examinez les éventuelles modifications concernant la facturation.

Principales différences entre les versions Advanced et Basic

Pour vous aider à comprendre vos tâches de migration, les sections suivantes décrivent les principales différences entre les éditions Advanced et Basic.

Comptes de service

Pour Cloud Translation – Basic, vous pouvez envoyer des requêtes authentifiées à l'aide de clés API ou de comptes de service.

Cloud Translation – Advanced intègre des fonctionnalités qui nécessitent des ressources gérées par le client. Ces ressources doivent être administrées via des rôles et autorisations IAM. Par conséquent, vous ne pouvez pas vous authentifier auprès du service avec des clés API. À la place, vous devez utiliser des comptes de service lors de l'authentification auprès de Cloud Translation – Advanced.

Pour en savoir plus, consultez le guide de configuration.

Rôles IAM

Lorsque vous utilisez des comptes de service pour Cloud Translation – Basic, ils ne sont utilisés que pour l'authentification. Vous pouvez appeler Cloud Translation – Basic, quelles que soient les autorisations associées au compte de service. En revanche, les autorisations s'appliquent à Cloud Translation – Advanced.

Pour accorder aux comptes de service l'autorisation d'appeler Cloud Translation – Advanced, vous devez leur attribuer des rôles IAM. Cloud Translation – Advanced comporte plusieurs rôles IAM que vous pouvez attribuer à votre compte de service afin d'accéder à des ressources spécifiques de votre projet. Par exemple, si vous souhaitez utiliser votre compte de service pour traduire du texte, vous devez lui attribuer le rôle roles/cloudtranslate.user. Pour en savoir plus, consultez la page Rôles Cloud Translation – Advanced.

Si vous prévoyez d'utiliser des modèles AutoML ou des fonctionnalités qui dépendent de Cloud Storage, vous devez également inclure les rôles appropriés pour ces services. Pour afficher la liste de tous les rôles IAM, consultez la documentation relative aux rôles IAM.

Modèles de traduction

Lorsque vous demandez une traduction à partir de Cloud Translation – Basic, vous pouvez utiliser l'un des deux modèles généraux suivants: traduction automatique neuronale (NMT) ou traduction automatique sous-phrasique (PBMT). Pour Cloud Translation – Advanced, vous pouvez utiliser les modèles généraux ou un modèle personnalisé d'AutoML Translation.

Les comptes de service que vous utilisez pour les requêtes de traduction doivent disposer des autorisations permettant d'accéder aux modèles AutoML et généraux, qui peuvent se trouver dans différents projets. Par exemple, vous pouvez disposer d'un projet central contenant vos modèles de traduction pour simplifier la maintenance et la facturation. Les comptes de service de ce projet ou d'autres projets peuvent utiliser ces modèles, mais nécessitent des autorisations pour le faire.

Pour plus d'informations sur les modèles de traduction, consultez la page Traduire du texte (version Advanced).

Bibliothèques clientes

Les bibliothèques clientes et les méthodes de Cloud Translation – Advanced sont différentes de Cloud Translation – Basic. Par exemple, les appels à Cloud Translation – Advanced nécessitent des noms de ressources. Pour en savoir plus, consultez la présentation des bibliothèques clientes Cloud Translation – Advanced ou essayez le guide de démarrage rapide de traduction (édition avancée).

Ressources, projets et emplacements

Les requêtes adressées à Cloud Translation – Advanced requièrent le nom de la ressource que vous souhaitez utiliser. Une ressource correspond généralement à un nom complet qui comprend le nom du projet et son emplacement, qui spécifient l'endroit où la requête est exécutée. Par exemple, le nom d'un modèle AutoML est un nom de ressource.

Si votre projet Google Cloud porte le nom my-project et que l'emplacement de la ressource est us-central1, le nom complet de vos ressources peut ressembler à ceci:

projects/MY_PROJECT/locations/us-central1/...

L'URL à laquelle vous envoyez une requête getSupportedLanguages peut se présenter comme suit:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Limite de contenu par requête

L'API Cloud Translation est optimisée pour la traduction de requêtes plus petites. La longueur maximale recommandée pour chaque requête est de 5 000 caractères (points de code). Cependant, plus vous envoyez de caractères, plus la latence de réponse est élevée. Pour Cloud Translation – Advanced, le nombre maximal de points de code pour une seule requête est de 30 000. Avec Cloud Translation – Basic, la taille maximale des requêtes est de 100 000 octets.

L'API Cloud Translation refuse les requêtes qui dépassent la limite maximale et génère un message d'erreur 400 INVALID_ARGUMENT, quel que soit le quota disponible.

Pour plus d'informations sur les quotas et les limites, consultez la page Quotas.

Étape suivante

Utilisez Cloud Translation – Advanced pour traduire du texte, créer des glossaires ou effectuer des requêtes par lot.