הגדרה

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

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

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

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

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

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

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

בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

תפקידים שנדרשים כדי לבחור או ליצור פרויקט

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

כניסה לדף לבחירת הפרויקט

הפעלת החיוב

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

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

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

מוודאים שהחיוב מופעל בפרויקט Google Cloud .

הפעלת ה-API

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

מפעילים את Cloud Translation API, אם הוא עדיין לא מופעל.

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

להפעלת ה-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

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

C#‎

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

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

אם משתמשים ב-Maven, צריך להוסיף את הקוד הבא לקובץ pom.xml. במאמר העוסק בספריות BOM ל-Google Cloud Platform תוכלו לקרוא מידע נוסף על עצי מוצרים (BOM).

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.90.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>

אם משתמשים ב-Gradle, צריך להוסיף את הקוד הבא ליחסי התלות:

implementation platform('com.google.cloud:libraries-bom:26.90.0')

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

אם משתמשים ב-sbt, צריך להוסיף את הקוד הבא ליחסי התלות:

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

אם משתמשים ב-Visual Studio Code או ב-IntelliJ, אפשר להוסיף את ספריות הלקוח לפרויקט באמצעות יישומי הפלאגין הבאים של IDE:

• ‏Cloud Code ל-VS Code
• ‏Cloud Code ל-IntelliJ

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

הערה: כרגע לא ניתן להשתמש בספריות לקוח של Cloud Java ב-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.

אם משתמשים ב-Maven, צריך להוסיף את הקוד הבא לקובץ pom.xml. במאמר העוסק בספריות BOM ל-Google Cloud Platform תוכלו לקרוא מידע נוסף על עצי מוצרים (BOM).

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.90.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>

אם משתמשים ב-Gradle, צריך להוסיף את הקוד הבא ליחסי התלות:

implementation platform('com.google.cloud:libraries-bom:26.90.0')

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

אם משתמשים ב-sbt, צריך להוסיף את הקוד הבא ליחסי התלות:

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

אם משתמשים ב-Visual Studio Code או ב-IntelliJ, אפשר להוסיף את ספריות הלקוח לפרויקט באמצעות יישומי הפלאגין הבאים של IDE:

• ‏Cloud Code ל-VS Code
• ‏Cloud Code ל-IntelliJ

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

הערה: כרגע לא ניתן להשתמש בספריות לקוח של Cloud Java ב-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 של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

gcloud init

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

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

gcloud auth application-default print-access-token

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

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

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

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

• בסקירה הכללית על המוצר מוסבר איך משתמשים בתכונות השונות של Cloud Translation.