Cette page a été traduite par l'API Cloud Translation.

Emplacements

Cloud Natural Language vous permet de contrôler où les ressources de votre projet sont stockées et traitées. Vous pouvez par exemple configurer Cloud Natural Language pour stocker vos données au repos et ne procéder au traitement de machine learning sur vos données que dans l'Union européenne ou aux États-Unis.

Par défaut, Cloud Natural Language stocke et traite les ressources dans un emplacement global, ce qui signifie qu'il ne garantit pas le maintien de vos ressources dans un emplacement ou une région spécifique. Si vous choisissez le lieu Union européenne, Google stocke vos données et effectue les opérations de machine learning uniquement dans l'Union européenne. Si vous choisissez le lieu États-Unis, Google stocke vos données et effectue les opérations de machine learning uniquement aux États-Unis. Vous et vos utilisateurs pouvez accéder aux données depuis n'importe quel emplacement.

Définir l'emplacement à l'aide de l'API

Cloud Natural Language accepte un point de terminaison d'API global (language.googleapis.com), un point de terminaison de l'Union européenne (eu-language.googleapis.com) et un point de terminaison aux États-Unis point de terminaison unique (us-language.googleapis.com). Pour traiter vos données dans l'Union européenne uniquement, utilisez l'URI eu-language.googleapis.com à la place de language.googleapis.com pour vos appels d'API REST. Pour traiter vos données aux États-Unis uniquement, utilisez l'URI us-language.googleapis.com à la place de language.googleapis.com pour vos appels d'API REST.

L'API de modération de texte est également disponible en Australie. Vous pouvez y accéder en utilisant l'URI au-language.googleapis.com à la place de language.googleapis.com pour vos appels d'API REST.

Définir l'emplacement à l'aide de bibliothèques clientes

Par défaut, les bibliothèques clientes accèdent au point de terminaison global de l'API (language.googleapis.com). Pour stocker et traiter vos données dans l'Union européenne ou aux États-Unis uniquement, vous devez définir explicitement le point de terminaison. Les exemples de code ci-dessous indiquent comment configurer ce paramètre.

Python

Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez la page Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Python Natural Language documentation de référence.

Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# Imports the Google Cloud client library
from google.cloud import language_v1

client_options = {"api_endpoint": "eu-language.googleapis.com:443"}

# Instantiates a client
client = language_v1.LanguageServiceClient(client_options=client_options)

Java

Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez la page Bibliothèques clientes Natural Language. Pour en savoir plus, consultez la documentation de référence de l'API Natural Language Java.

LanguageServiceSettings settings =
    LanguageServiceSettings.newBuilder().setEndpoint("eu-language.googleapis.com:443").build();

// Initialize client that will be used to send requests. This client only needs to be created
// once, and can be reused for multiple requests. After completing all of your requests, call
// the "close" method on the client to safely clean up any remaining background resources.
LanguageServiceClient client = LanguageServiceClient.create(settings);

Node.js

Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez la page Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Node.js Natural Language documentation de référence.

Pour vous authentifier auprès de Natural Language, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

// Imports the Google Cloud client library
const language = require('@google-cloud/language');

// Specifies the location of the api endpoint
const clientOptions = {apiEndpoint: 'eu-language.googleapis.com'};

// Instantiates a client
const client = new language.LanguageServiceClient(clientOptions);