Località

Cloud Natural Language ti offre un certo controllo su dove le risorse per il tuo progetto vengono archiviati ed elaborati. In particolare, puoi configurare Cloud Natural Language per archiviare i dati at-rest ed eseguire l'elaborazione del machine learning sui tuoi dati solo all'interno dell'Unione Europea o degli Stati Uniti.

Per impostazione predefinita, Cloud Natural Language archivia ed elabora le risorse in una località globale, il che significa che Cloud Natural Language non garantisce che le tue risorse all'interno di una determinata località o regione. Se scegli la località Unione Europea: Google memorizzerà i tuoi dati ed eseguirà il machine learning con questi dati solo nell'Unione Europea. Se scegli Stati Uniti, Google memorizzerà i tuoi dati ed eseguirà il machine learning con questi solo nella Stati Uniti. Tu e i tuoi utenti potete accedere ai dati da qualsiasi luogo.

Impostazione della località tramite l'API

Cloud Natural Language supporta un endpoint API globale (language.googleapis.com), endpoint dell'Unione Europea (eu-language.googleapis.com) e degli Stati Uniti (us-language.googleapis.com). Per elaborare i tuoi dati solo nell'Unione Europea, utilizza l'URI eu-language.googleapis.com al posto di language.googleapis.com per le chiamate API REST. Per elaborare i tuoi dati solo negli Stati Uniti, utilizza l'URI us-language.googleapis.com al posto di language.googleapis.com per le chiamate API REST.

L'API di moderazione del testo è disponibile anche in Australia, a cui è possibile accedere utilizzando l'URI au-language.googleapis.com al posto di language.googleapis.com per le chiamate API REST.

Impostazione della località utilizzando le librerie client

Le librerie client accedono all'endpoint API globale (language.googleapis.com) per impostazione predefinita. Per archiviare ed elaborare i tuoi dati solo nell'Unione Europea o negli Stati Uniti, devi: di impostare in modo esplicito l'endpoint. Gli esempi di codice riportati di seguito mostrano come configurare questa impostazione.

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