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 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 stocker et 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 stocker et 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.

Pour la modération du texte, vous pouvez choisir de stocker et de traiter vos données en Australie (Preview). Pour ce faire, utilisez l'URI au-language.googleapis.com au lieu 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

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.

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.

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 la documentation de référence de l'API Natural Language Node.js.

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