שילוב של Google Translate עם Google SecOps
במאמר הזה מוסבר איך להגדיר את Google Translate ולשלב אותו עם Google Security Operations (Google SecOps).
לפני שמתחילים
כדי להשתמש בשילוב, צריך ליצור ולהגדיר מפתח API.
יצירת מפתח ה-API
כדי ליצור את מפתח ה-API:
במסוף Google Cloud , נכנסים לדף APIs & Services > Credentials.
לוחצים על add Create credentials.
בוחרים באפשרות API key כדי ליצור מפתח API חדש. מופיעה תיבת דו-שיח עם מפתח API שנוצר.
כדי להעתיק את מפתח ה-API, לוחצים על Copy.
הגדרת ההגבלות על מפתחות ה-API
כדי להגדיר את ההגבלה על מפתח ה-API, מבצעים את השלבים הבאים:
לוחצים על Restrict key.
בקטע API restrictions, בוחרים באפשרות Restrict key.
בוחרים באפשרות Cloud Translation API מרשימת ממשקי ה-API.
מגדירים את ההגבלות הרלוונטיות.
לוחצים על Save כדי לשמור את ההגדרות של מפתח ה-API.
פרמטרים של שילוב
השילוב של Google Translate דורש את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה. שורש ה-API של המכונה של Google Translate. ערך ברירת המחדל הוא
למידע נוסף על Cloud Translation API, קראו את המאמר Cloud Translation API. |
API Key |
חובה. מפתח ה-API של החשבון ב-Google Translate. |
Verify SSL |
חובה. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של Google Translate. האפשרות הזו מסומנת כברירת מחדל. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
רשימת שפות
משתמשים בפעולה List Languages כדי להציג את רשימת השפות הזמינות ב-Google Translate.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה List Languages דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Filter Key |
זה שינוי אופציונלי. מקש לסינון שפות. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Filter Logic |
זה שינוי אופציונלי. לוגיקת הסינון שרוצים להחיל. לוגיקת הסינון משתמשת בערך שהגדרתם בפרמטר הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Filter Value |
זה שינוי אופציונלי. ערך לשימוש במסנן. לוגיקת הסינון משתמשת בערך שהגדרתם בפרמטר אם האפשרות אם לא בוחרים ערך, הפעולה מתעלמת מהמסנן. לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר |
Max Records To Return |
זה שינוי אופציונלי. המספר המקסימלי של רשומות שיוחזרו. הערך המקסימלי הוא אם לא מגדירים ערך, הפעולה מחזירה 50 רשומות כברירת מחדל. |
ערכי פלט של פעולות
הפעולה List Languages מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קונסולה צמוד לקיר
הפעולה List Languages יכולה ליצור את הטבלה הבאה:
שם הטבלה: השפות הזמינות
עמודה בטבלה: Language Key
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Languages:
{
"data": {
"languages": [
{
"language": "af"
},
{
"language": "am"
},
{
"language": "ar"
}
]
}
}
הודעות פלט
הפעולה List Languages יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "List Languages". Reason: ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List Languages:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
פינג
משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Google Translate.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
הפעולה פינג מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
הודעות פלט
הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Failed to connect to the Google Translate server! Error is ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה פינג:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
תרגום טקסט
משתמשים בפעולה Translate Text כדי לתרגם טקסט באמצעות Google Translate.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Translate Text דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Source Language |
זה שינוי אופציונלי. שפת המקור של הטקסט. אם לא מגדירים את הפרמטר הזה, הפעולה מזהה את השפה באופן אוטומטי. |
Target Language |
חובה. שפת יעד. ערך ברירת המחדל הוא
|
Text |
חובה. טקסט לתרגום. |
ערכי פלט של פעולות
הפעולה Translate Text מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Translate Text:
{
"data": {
"translations": [
{
"translatedText": "TRANSLATED_TEXT"
}
]
}
}
הודעות פלט
הפעולה תרגום טקסט יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Translate Text". Reason: ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Translate Text:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
True או False |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.