Ubicaciones

Cloud Natural Language te ofrece cierto control sobre dónde se procesan los recursos de tu proyecto. En concreto, puedes configurar Cloud Natural Language para que realice el procesamiento de aprendizaje automático de tus datos solo en la UE o en EE. UU.

De forma predeterminada, Cloud Natural Language procesa los recursos en una ubicación Global, lo que significa que Cloud Natural Language no garantiza que tus recursos permanezcan en una ubicación o región concretas. Si eliges la ubicación Unión Europea, Google solo aplicará el aprendizaje automático en la UE. Si eliges la ubicación Estados Unidos, Google solo usará el aprendizaje automático en ese país. Tanto tú como tus usuarios podéis acceder a los datos desde cualquier ubicación.

Definir la ubicación mediante la API

Cloud Natural Language admite un endpoint de API global (language.googleapis.com), un endpoint de la Unión Europea (eu-language.googleapis.com) y un endpoint de Estados Unidos (us-language.googleapis.com). Para procesar tus datos solo en la Unión Europea, usa el URI eu-language.googleapis.com en lugar de language.googleapis.com en tus llamadas a la API REST. Para tratar sus datos únicamente en Estados Unidos, utilice el URI us-language.googleapis.com en lugar de language.googleapis.com en sus llamadas a la API REST.

La API de moderación de texto también está disponible en Australia. Para acceder a ella, puedes usar el URI au-language.googleapis.com en lugar de language.googleapis.com en tus llamadas a la API REST.

Definir la ubicación mediante bibliotecas de cliente

Las bibliotecas de cliente acceden al endpoint de la API global (language.googleapis.com) de forma predeterminada. Para almacenar y tratar tus datos únicamente en la Unión Europea o en Estados Unidos, debes definir el endpoint de forma explícita. En los ejemplos de código que se muestran a continuación se explica cómo configurar este ajuste.

Python

Para saber cómo instalar y usar la biblioteca de cliente de Natural Language, consulta el artículo sobre las bibliotecas de cliente de Natural Language. Para obtener más información, consulta la documentación de referencia de la API Natural Language Python.

Para autenticarte en Natural Language, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo 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

Para saber cómo instalar y usar la biblioteca de cliente de Natural Language, consulta el artículo sobre las bibliotecas de cliente de Natural Language. Para obtener más información, consulta la documentación de referencia de la API Natural Language Java.

Para autenticarte en Natural Language, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo 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

Para saber cómo instalar y usar la biblioteca de cliente de Natural Language, consulta el artículo sobre las bibliotecas de cliente de Natural Language. Para obtener más información, consulta la documentación de referencia de la API Natural Language Node.js.

Para autenticarte en Natural Language, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo 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);