שילוב של Google Translate עם Google SecOps

במאמר הזה מוסבר איך להגדיר את Google Translate ולשלב אותו עם Google Security Operations ‏ (Google SecOps).

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

כדי להשתמש בשילוב, צריך ליצור ולהגדיר מפתח API.

יצירת מפתח ה-API

כדי ליצור את מפתח ה-API:

  1. במסוף Google Cloud , נכנסים לדף APIs & Services > Credentials.

    כניסה לדף Credentials

  2. לוחצים על add Create credentials.

  3. בוחרים באפשרות API key כדי ליצור מפתח API חדש. מופיעה תיבת דו-שיח עם מפתח API שנוצר.

  4. כדי להעתיק את מפתח ה-API, לוחצים על Copy.

הגדרת ההגבלות על מפתחות ה-API

כדי להגדיר את ההגבלה על מפתח ה-API, מבצעים את השלבים הבאים:

  1. לוחצים על Restrict key.

  2. בקטע API restrictions, בוחרים באפשרות Restrict key.

  3. בוחרים באפשרות Cloud Translation API מרשימת ממשקי ה-API.

  4. מגדירים את ההגבלות הרלוונטיות.

  5. לוחצים על Save כדי לשמור את ההגדרות של מפתח ה-API.

פרמטרים של שילוב

השילוב של Google Translate דורש את הפרמטרים הבאים:

פרמטר תיאור
API Root

חובה.

שורש ה-API של המכונה של Google Translate.

ערך ברירת המחדל הוא https://translation.googleapis.com.

למידע נוסף על 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

זה שינוי אופציונלי.

מקש לסינון שפות.

הערכים האפשריים הם:

  • Select One
  • Name

ערך ברירת המחדל הוא Select One.

Filter Logic

זה שינוי אופציונלי.

לוגיקת הסינון שרוצים להחיל.

לוגיקת הסינון משתמשת בערך שהגדרתם בפרמטר Filter Key.

הערכים האפשריים הם:

  • Not Specified
  • Equal
  • Contains

ערך ברירת המחדל הוא Not Specified.

Filter Value

זה שינוי אופציונלי.

ערך לשימוש במסנן.

לוגיקת הסינון משתמשת בערך שהגדרתם בפרמטר Filter Key.

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

אם לא בוחרים ערך, הפעולה מתעלמת מהמסנן.

לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key.

Max Records To Return

זה שינוי אופציונלי.

המספר המקסימלי של רשומות שיוחזרו.

הערך המקסימלי הוא 50.

אם לא מגדירים ערך, הפעולה מחזירה 50 רשומות כברירת מחדל.

ערכי פלט של פעולות

הפעולה List Languages מספקת את הפלטים הבאים:

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

הפעולה List Languages יכולה ליצור את הטבלה הבאה:

שם הטבלה: השפות הזמינות

עמודה בטבלה: Language Key

תוצאת JSON

הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Languages:

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
הודעות פלט

הפעולה List Languages יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

The filter was not applied, because parameter "Filter Value" has an empty value.

הפעולה בוצעה בהצלחה.
Error executing action "List Languages". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List Languages:

שם תוצאת הסקריפט ערך
is_success True או False

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Google Translate.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

אין.

ערכי פלט של פעולות

הפעולה פינג מספקת את הפלטים הבאים:

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

הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully connected to the Google Translate server with the provided connection parameters!

הפעולה בוצעה בהצלחה.
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

חובה.

שפת יעד.

ערך ברירת המחדל הוא en.

Text

חובה.

טקסט לתרגום.

ערכי פלט של פעולות

הפעולה Translate Text מספקת את הפלטים הבאים:

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

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Translate Text:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
הודעות פלט

הפעולה תרגום טקסט יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully translated the provided text in Google Translate.

הפעולה בוצעה בהצלחה.
Error executing action "Translate Text". Reason: ERROR_REASON

הפעולה נכשלה.

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

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Translate Text:

שם תוצאת הסקריפט ערך
is_success True או False

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.