הגדרה

כדי להתחיל להשתמש ב-Cloud Translation, צריך פרויקט שבו Cloud Translation API מופעל, ופרטי כניסה כדי לבצע קריאות מאומתות. בקטעים הבאים מוסבר איך להגדיר את Cloud Translation API לפני שמבצעים את הקריאה הראשונה ל-API.

תהליך ההגדרה כולל את מסוף Google Cloud , שהוא ממשק אינטרנט שבאמצעותו אפשר להקצות, להגדיר, לנהל ולנטר מערכות ב-Google Cloud. אם לא השתמשתם במסוף Google Cloud בעבר, תוכלו לקרוא מידע נוסף בדף מסוף Cloud.

לפני שמתחילים

‫Cloud Translation זמין בשתי מהדורות (Basic ו-Advanced). צריך להחליט באיזו מהדורות להשתמש, כי לכל מהדורה יש קבוצה משלה של ספריות לקוח.

יצירה או בחירה של פרויקט

כדי להשתמש בשירותים שמסופקים על ידי Google Cloud, אתם צריכים ליצור פרויקט. בפרויקט מאורגנים כל המשאבים שלכם ב- Google Cloud . כל פרויקט כולל קבוצה של שותפי עריכה, ממשקי API שמופעלים (וכן משאבים אחרים), כלי מעקב, פרטי חיוב ואמצעי בקרה לאימות ולגישה. אתם יכולים ליצור פרויקט אחד או כמה פרויקטים, ולהשתמש בהם כדי לארגן את המשאבים ב- Google Cloud בהיררכיית משאבים. כשיוצרים פרויקט, חשוב לשים לב למזהה הפרויקט. תצטרכו את המזהה הזה כדי לבצע קריאות ל-API. מידע נוסף על פרויקטים זמין במשאבי העזרה של מנהל המשאבים.

מומלץ ליצור פרויקטים נפרדים לניסויים, לבדיקות ולייצור. אחרי שיוצרים פרויקט, רושמים את מספר הפרויקט או המזהה שלו. כששולחים קריאות ל-Cloud Translation API, צריך לציין את מספר הפרויקט (או המזהה שלו).

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

הפעלת החיוב

כדי להשתמש ב-Cloud Translation, צריך להפעיל את החיוב. מידע נוסף על התמחור של Cloud Translation מופיע בדף התמחור.

הערה: כדי לעזור לכם לנהל את התקציב, אתם יכולים להגדיר את מגבלות השימוש בפרויקטים. מידע נוסף מופיע במאמר בנושא הגדרת מכסות שימוש.

באמצעות החשבון לחיוב תוכלו לקבוע מי משלם על קבוצה מסוימת של משאבים, וכן לקשר את החשבון לפרויקט אחד או יותר. השימוש בפרויקט מחויב בחשבון שמקושר לחיוב ב-Cloud. ברוב המקרים, מגדירים את החיוב בזמן שיוצרים פרויקט. מידע נוסף זמין במשאבי העזרה בנושא חיוב.

Verify that billing is enabled for your Google Cloud project.

הפעלת ה-API

צריך להפעיל את Cloud Translation API בפרויקט. רוצים לדעת איך מפעילים או משביתים שירותים?

Enable the Cloud Translation API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

הגדרת מכסות שימוש

ל-Cloud Translation יש מערכת לניהול מכסות שעוזרת לכם ול-Google לנהל את השימוש בשירות. כברירת מחדל, מספר התווים שאפשר לשלוח ביום הוא בלתי מוגבל. אם יש לכם תקציב מוגדר, מומלץ לעקוב אחרי השימוש היומי ולהתאים את המכסות בהתאם להוצאות המתוכננות.

מידע נוסף על מכסות זמין במאמר מכסות ומגבלות.

מגדירים אימות

אם אתם מתכוונים להשתמש ב-Cloud Translation API, עליכם להגדיר אימות. כל יישום לקוח שמשתמש ב-API צריך לעבור אימות ולקבל גישה למשאבים הנדרשים. מידע נוסף זמין במאמר בנושא אימות ל-Cloud Translation.

תפקידים בניהול זהויות והרשאות גישה (IAM)

כשחשבון משתמש, חשבון שירות וכו' (שנקראים 'גורם ראשי') קוראים ל-API,Google Cloud דורש שלגורם הראשי יהיו ההרשאות המתאימות. אפשר להעניק הרשאות על ידי הקצאת תפקידים לחשבון משתמש. מידע נוסף זמין במאמר בקרת גישה באמצעות IAM.

הערה: הרשאות התפקיד רלוונטיות רק ל-Cloud Translation – Advanced. אפשר להשתמש בחשבונות שירות בשתי המהדורות, אבל אפשר להגדיר הרשאות ספציפיות רק ל-Cloud Translation Advanced. ב-Cloud Translation – Basic, אתם יכולים להגיש כל בקשה בלי קשר להרשאות של חשבון השירות.

התקנת ספריות לקוח

ספריות לקוח זמינות בכמה שפות פופולריות. מומלץ להשתמש בספריות הלקוח האלה כדי לבצע קריאות ל-Cloud Translation, כי הן מפשטות את הגישה לממשקי ה-API. אם ספריית לקוח לא עונה על הצרכים שלכם או לא זמינה בשפה שלכם, אתם יכולים ליצור קוד מותאם אישית משלכם. מידע נוסף זמין במאמר בנושא שימוש בקוד לקוח משלכם.

לדוגמה, כשמשתמשים בספריית לקוח, היא יכולה לקבוע את פרטי הכניסה באופן לא מפורש באמצעות משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS. אין צורך לציין מפורשות את פרטי הכניסה בקוד. מידע נוסף זמין במאמר הסבר על ספריות לקוח במאמרי העזרה בנושא Cloud APIs.

ספריות לקוח של Cloud Translation – Basic

בוחרים את שפת התכנות שבה משתמשים לפיתוח, ואז מריצים את הפקודה שקשורה אליה. מידע נוסף זמין במאמר סקירה כללית על ספריות הלקוח של Cloud Translation – Basic.

C#‎

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

זהירות: ספריית הלקוח Java לא תומכת ב-Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.76.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.85.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.85.0"

If you're using Visual Studio Code or IntelliJ, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

מידע נוסף על הגדרת סביבת הפיתוח ב-Node.js מופיע במדריך להגדרת סביבת הפיתוח ב-Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

מידע נוסף על הגדרת סביבת הפיתוח בשפת Python מופיע במדריך להגדרת סביבת הפיתוח בשפת Python.

pip install google-cloud-translate==2.0.1

Ruby

מידע נוסף על הגדרת סביבת הפיתוח בשפת Ruby מופיע במדריך להגדרת סביבת הפיתוח בשפת Ruby.

gem install google-cloud-translate-v2

Cloud Translation – ספריות לקוח מתקדמות

בוחרים את שפת התכנות שבה משתמשים לפיתוח, ואז מריצים את הפקודה שקשורה אליה. מידע נוסף זמין במאמר סקירה כללית על ספריות לקוח של Cloud Translation – Advanced.

C#‎

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

Java

זהירות: ספריית הלקוח Java לא תומכת ב-Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.76.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.85.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.85.0"

If you're using Visual Studio Code or IntelliJ, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

מידע נוסף על הגדרת סביבת הפיתוח ב-Node.js מופיע במדריך להגדרת סביבת הפיתוח ב-Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

מידע נוסף על הגדרת סביבת הפיתוח בשפת Python מופיע במדריך להגדרת סביבת הפיתוח בשפת Python.

pip install --upgrade google-cloud-translate

Ruby

מידע נוסף על הגדרת סביבת הפיתוח בשפת Ruby מופיע במדריך להגדרת סביבת הפיתוח בשפת Ruby.

gem install google-cloud-translate

התקנת Google Cloud CLI

הערה: אפשר לדלג על השלב הזה אם לא תשתמשו בשורת הפקודה כדי לבצע קריאות מאומתות ל-API.

אם אתם מתכננים לשלוח בקשות ל-Cloud Translation דרך שורת הפקודה (למשל באמצעות פקודות curl), התקינו והפעילו את ה-CLI של gcloud, שכלול ב-Google Cloud CLI. בקישור הבא תוכלו לקרוא מידע נוסף:

התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

gcloud init

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

בדיקת ה-SDK והאימות

אם הגדרתם את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS, תוכלו להשתמש ב-gcloud כדי לבדוק את סביבת האימות. מפעילים את הפקודה הבאה כדי לוודא שאין שגיאות ושפרטי הכניסה מוחזרים:

gcloud auth application-default print-access-token

הפקודה הקודמת משמשת כדי לאמת שליחת קריאות ל-API בכל הדוגמאות לשליחת קריאה ל-Cloud Translation API באמצעות שורות הפקודה ב-REST.

המאמרים הבאים

• כדאי לנסות את המדריכים להתחלה מהירה כדי לבצע שיחות תרגום פשוטות:

  • Cloud Translation - Basic quickstart
  • Cloud Translation – מדריך למתחילים בנושא תכונות מתקדמות

• מידע נוסף על השימוש בתכונות השונות של Cloud Translation זמין בסקירה הכללית על המוצר.

נסו בעצמכם

אנחנו ממליצים למשתמשים חדשים ב-Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של Cloud Translation בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300 $להרצה, לבדיקה ולפריסה של עומסי העבודה.

להתנסות ב-Cloud Translation בחינם