Località

Cloud Natural Language ti offre un certo controllo su dove vengono archiviate ed elaborate le risorse del progetto. In particolare, puoi configurare Cloud Natural Language per archiviare i dati at-rest ed eseguire l'elaborazione tramite machine learning sui tuoi dati solo nell'Unione Europea o negli 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 risorse rimarranno in una determinata località o regione. Se scegli la località Unione Europea, Google archivierà i tuoi dati ed eseguirà il machine learning al suo interno solo nell'Unione Europea. Se scegli la località Stati Uniti, Google memorizzerà i tuoi dati ed eseguirà il machine learning con questi dati solo negli Stati Uniti. Tu e i tuoi utenti potete accedere ai dati da qualsiasi luogo.

Impostazione della località mediante l'API

Cloud Natural Language supporta un endpoint API globale (language.googleapis.com), un endpoint dell'Unione Europea (eu-language.googleapis.com) e un endpoint degli Stati Uniti (us-language.googleapis.com). Per archiviare ed 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 archiviare ed elaborare i dati solo negli Stati Uniti, utilizza l'URI us-language.googleapis.com al posto di language.googleapis.com per le chiamate API REST.

Per la moderazione del testo, puoi scegliere di archiviare ed elaborare i tuoi dati in Australia (anteprima). A questo scopo, utilizza l'URI au-language.googleapis.com al posto di language.googleapis.com per le chiamate API REST.

Impostazione della località utilizzando le librerie client

Per impostazione predefinita, le librerie client accedono all'endpoint API globale (language.googleapis.com). Per archiviare ed elaborare i dati solo nell'Unione Europea o negli Stati Uniti, devi impostare esplicitamente l'endpoint. I seguenti esempi di codice mostrano come configurare questa impostazione.

Python

Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Natural Language Python.

Per eseguire l'autenticazione in Natural Language, imposta Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

# 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

Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Natural Language Java.

Per eseguire l'autenticazione in Natural Language, imposta Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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

Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Natural Language Node.js.

Per eseguire l'autenticazione in Natural Language, imposta Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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