Locais

Ao usar a Cloud Natural Language, você tem algum controle sobre onde os recursos do seu projeto são armazenados e processados. Mais especificamente, é possível configurar a Cloud Natural Language para armazenar seus dados em repouso e executar o processamento de machine learning nos dados apenas na União Europeia ou nos Estados Unidos.

Por padrão, a Cloud Natural Language armazena e processa recursos em um local global, o que significa que o Cloud Natural Language não garante que seus recursos permanecerão em um determinado local ou região. Se você escolher o local União Europeia, o Google armazenará seus dados e realizará o machine learning com eles somente na União Europeia. Se você escolher o local Estados Unidos, o Google armazenará seus dados e realizará o machine learning com eles somente nos Estados Unidos. Você e seus usuários podem acessar os dados de qualquer local.

Como definir o local usando a API

A Cloud Natural Language é compatível com um endpoint global da API (language.googleapis.com), um endpoint da União Europeia (eu-language.googleapis.com) e um endpoint dos Estados Unidos (us-language.googleapis.com). Para processar seus dados apenas na União Europeia, use o URI eu-language.googleapis.com no lugar de language.googleapis.com para suas chamadas da API REST. Para processar seus dados somente nos Estados Unidos, use o URI us-language.googleapis.com no lugar de language.googleapis.com para suas chamadas da API REST.

A API de moderação de texto também está disponível na Austrália. Para acessá-la, use o URI au-language.googleapis.com em vez de language.googleapis.com nas suas chamadas da API REST.

Como definir o local usando bibliotecas de cliente

As bibliotecas de cliente acessam o endpoint da API global (language.googleapis.com) por padrão. Para armazenar e processar seus dados apenas na União Europeia ou nos Estados Unidos, defina explicitamente o endpoint. Os exemplo de código abaixo mostram como definir essa configuração.

Python

Para saber como instalar e usar a biblioteca de cliente para a Natural Language, consulte Bibliotecas de cliente da Natural Language. Para mais informações, consulte a documentação de referência da API Natural Language Python.

Para se autenticar no Natural Language, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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 como instalar e usar a biblioteca de cliente para a Natural Language, consulte Bibliotecas de cliente da Natural Language. Para mais informações, consulte a documentação de referência da API Natural Language Java.

Para se autenticar no Natural Language, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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 como instalar e usar a biblioteca de cliente para a Natural Language, consulte Bibliotecas de cliente da Natural Language. Para mais informações, consulte a documentação de referência da API Natural Language Node.js.

Para se autenticar no Natural Language, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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);