位置

借助 Cloud Natural Language，您可以控制存储和处理项目资源的位置。具体来说，您可以将 Cloud Natural Language 配置为仅在欧盟或美国存储您的静态数据以及对您的数据执行机器学习。

默认情况下，Cloud Natural Language 在全球位置存储和处理资源，这意味着 Cloud Natural Language 不保证您的资源将保留在特定的位置或区域内。如果您选择欧盟位置，则 Google 只会在欧盟存储您的数据以及对其执行机器学习。如果您选择美国位置，则 Google 只会在美国存储您的数据以及对其执行机器学习。您和您的用户可以从任意位置访问该数据。

使用 API 设置位置

Cloud Natural Language API 支持全球 API 端点 (language.googleapis.com)、欧盟端点 (eu-language.googleapis.com)、美国端点 (us-language.googleapis.com)。如需仅在欧盟存储和处理您的数据，请在 REST API 调用中使用 URI eu-language.googleapis.com（而不是 language.googleapis.com）。如需仅在美国存储和处理您的数据，请在 REST API 调用中使用 URI us-language.googleapis.com（而不是 language.googleapis.com）。

对于“文本审核”，您可以选择在澳大利亚存储和处理您的数据（预览版）。为此，请在 REST API 调用中使用 URI au-language.googleapis.com（而不是 language.googleapis.com）。

使用客户端库设置位置

默认情况下，客户端库会访问全球 API 端点 (language.googleapis.com)。如需仅在欧盟或美国存储和处理您的数据，您需要明确设置相应端点。以下代码示例展示了如何配置此设置。

Python

如需了解如何安装和使用 Natural Language 的客户端库，请参阅 Natural Language 客户端库。 如需了解详情，请参阅 Natural Language Python API 参考文档。

如需向 Natural Language 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

# 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

如需了解如何安装和使用 Natural Language 的客户端库，请参阅 Natural Language 客户端库。 如需了解详情，请参阅 Natural Language Java API 参考文档。

如需向 Natural Language 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

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

如需了解如何安装和使用 Natural Language 的客户端库，请参阅 Natural Language 客户端库。 如需了解详情，请参阅 Natural Language Node.js API 参考文档。

如需向 Natural Language 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为本地开发环境设置身份验证。

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