מיקומים

שירות Cloud Natural Language מאפשר לכם לשלוט במיקום שבו המשאבים של הפרויקט שלכם מעובדים. בפרט, אתם יכולים להגדיר את Cloud Natural Language כך שיבצע עיבוד של למידת מכונה על הנתונים שלכם רק באיחוד האירופי או בארה"ב.

כברירת מחדל, Cloud Natural Language מעבד משאבים במיקום Global, כלומר Cloud Natural Language לא מבטיח שהמשאבים יישארו במיקום או באזור מסוימים. אם תבחרו במיקום האיחוד האירופי, Google תבצע למידת מכונה רק באיחוד האירופי. אם תבחרו במיקום ארצות הברית, Google תבצע למידת מכונה עם המיקום הזה רק בארה"ב. אתם והמשתמשים שלכם יכולים לגשת לנתונים מכל מקום.

הגדרת המיקום באמצעות ה-API

‫Cloud Natural Language תומך בנקודת קצה ל-API גלובלית (language.googleapis.com), בנקודת קצה ל-API באיחוד האירופי (eu-language.googleapis.com) ובנקודת קצה ל-API בארצות הברית (us-language.googleapis.com). כדי לעבד את הנתונים רק באיחוד האירופי, צריך להשתמש ב-URI‏ eu-language.googleapis.com במקום language.googleapis.com לקריאות ל-API בארכיטקטורת REST. כדי לעבד את הנתונים רק בארצות הברית, צריך להשתמש ב-URI‏ us-language.googleapis.com במקום ב-language.googleapis.com בקריאות ל-API בארכיטקטורת REST.

ה-API למודרציה של טקסטים זמין גם באוסטרליה. כדי לגשת אליו, צריך להשתמש ב-URI‏ au-language.googleapis.com במקום language.googleapis.com בקריאות ל-API בארכיטקטורת REST.

הגדרת המיקום באמצעות ספריות לקוח

ספריות הלקוח ניגשות לנקודת הקצה הגלובלית של ה-API‏ (language.googleapis.com) כברירת מחדל. כדי לאחסן ולעבד את הנתונים רק באיחוד האירופי או בארצות הברית, צריך להגדיר במפורש את נקודת הקצה. בדוגמאות הקוד שבהמשך אפשר לראות איך מגדירים את ההגדרה הזו.

Python

מידע על התקנת ספריית הלקוח של Natural Language ושימוש בה מופיע במאמר ספריות הלקוח של Natural Language. מידע נוסף מופיע במאמרי העזרה של Natural Language Python API.

כדי לבצע אימות ב-Natural Language, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

# 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, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

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, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

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