Locais

A Cloud Natural Language oferece algum controle sobre onde os recursos do seu projeto são processados. Especificamente, é possível configurar a Cloud Natural Language para executar o processamento de machine learning nos seus dados somente na UE ou nos EUA.

Por padrão, a Cloud Natural Language processa recursos em um local global, o que significa que a 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 vai realizar o aprendizado de máquina somente na UE. Se você escolher o local Estados Unidos, o Google vai realizar o machine learning somente nos EUA. 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);