מדריך למתחילים: הגדרת Natural Language API

במדריך הזה מפורטים כל השלבים להגדרה ולשימוש ב-Natural Language.

היכרות עם מסוף Google Cloud

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

יצירת פרויקט

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

בפרויקט מאורגנים כל המשאבים שלכם ב- Google Cloud . פרויקט מורכב מהרכיבים הבאים:

  • קבוצה של שותפי עריכה
  • ממשקי API מופעלים (ומשאבים אחרים)
  • כלי מעקב
  • פרטי חיוב
  • אימות ואמצעי בקרה לגישה

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

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

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

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

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

הפעלת החיוב

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

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

הפעלת ה-API

צריך להפעיל את Cloud Natural Language API בפרויקט. למידע נוסף על הפעלת ממשקי API, ראו את התיעוד של Service Usage.

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

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

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

להפעלת ה-API

התקנה והפעלה של ה-CLI של gcloud

אם אתם מתכוונים להשתמש ב-Natural Language API, אתם צריכים להתקין ולהפעיל את gcloud CLI. ‏gcloud CLI היא קבוצת כלים שבעזרתם אפשר לנהל את המשאבים והאפליקציות שמתארחים ב- Google Cloud. אחד מהכלים האלה הוא ה-CLI של gcloud. אתם יכולים להיעזר בהוראות שבקישורים האלה:

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

gcloud init

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

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

בוחרים את הכרטיסיות שמתאימות לאופן שבו אתם מתכננים לגשת ל-API:

gcloud

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

gcloud init

ספריות לקוח

כדי להשתמש בספריות לקוח בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.

  1. התקינו את ה-CLI של Google Cloud.

  2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

    איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

  3. יוצרים פרטי כניסה לאימות מקומי עבור חשבון המשתמש: 

    gcloud auth application-default login

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

למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .

REST

כדי להשתמש ב-API בארכיטקטורת REST בסביבת פיתוח מקומית, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

    מתקינים את ה-CLI של Google Cloud ואז נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

למידע נוסף על הגדרת אימות בסביבת ייצור, ראו את המאמר בנושא הגדרת Application Default Credentials לקוד שפועל ב- Google Cloud במאמרי העזרה בנושא אימות ב- Google Cloud .

התקנה של ספריית הלקוח של Natural Language API

יש שלוש אפשרויות לשלוח קריאה ל-Natural Language API:

ספריות הלקוח זמינות בכמה שפות נפוצות. במאמר ספריות הלקוח של Cloud Natural Language מוסבר איך להתקין את ספריות הלקוח.

תפקידי IAM

כדי לקבל את ההרשאות שנדרשות לגישה ל-Cloud Natural Language API, בקשו מהאדמין לתת לכם את התפקיד Service Usage Consumer ‏ (roles/serviceusage.serviceUsageConsumer) ב-IAM בפרויקט המכסה. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.