É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 ne procéder au traitement de machine learning sur vos données que 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 n'effectuera les opérations de machine learning qu'au sein de l'UE. Si vous choisissez les États-Unis comme emplacement, Google n'effectuera les opérations de machine learning qu'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 de 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.

# 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)

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

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