Locais

Com a Cloud Natural Language, você tem algum controle sobre onde os recursos do seu projeto são processados. Em especial, é possível configurar a Cloud Natural Language para realizar 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 a União Europeia como local, o Google vai realizar o machine learning com eles somente na UE. Se você escolher o local Estados Unidos, o Google vai realizar o machine learning com eles somente nos EUA. Você e seus usuários podem acessar os dados de qualquer local.

Como definir o local usando a API

A API 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 Text Moderation 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 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.

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