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

Établissements

Cloud Natural Language vous permet de contrôler où les ressources de votre projet sont traitées. Vous pouvez par exemple configurer Cloud Natural Language pour effectuer le traitement de machine learning sur vos données uniquement dans l'UE ou aux États-Unis.

Par défaut, Cloud Natural Language 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 l'Union européenne comme emplacement, Google effectue les opérations de machine learning uniquement dans l'UE. Si vous choisissez les États-Unis comme emplacement, Google 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 est compatible avec un point de terminaison global de l'API (language.googleapis.com), un point de terminaison en Union européenne (eu-language.googleapis.com) et un point de terminaison aux États-Unis (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 du texte est également disponible en Australie. Pour y accéder, utilisez 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 la documentation de référence de l'API Natural Language Python.

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

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

// 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);