הגדרה

כדי להתחיל להשתמש ב-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. מידע נוסף על פרויקטים זמין במשאבי העזרה של מנהל המשאבים.

מומלץ ליצור פרויקטים נפרדים לניסויים, לבדיקות ולייצור. אחרי שיוצרים פרויקט, רושמים את מספר הפרויקט או המזהה שלו. כששולחים קריאות ל-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 בפרויקט. למידע נוסף על הפעלת ממשקי API, ראו את התיעוד של Service Usage.

מפעילים את 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, כי הן מאפשרות גישה קלה יותר לממשקי ה-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

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

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

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