דיווח על שימוש באמצעות תוויות (מתקדם)

‫Cloud Translation API תומך בהוספה של תוויות שמוגדרות על ידי המשתמש (צמדי מפתח/ערך) לבקשות TranslateText, BatchTranslateText ו-DetectLanguage. המידע על השימוש בבקשה מועבר למערכת החיוב, שבה אפשר לסנן לפי תוויות כדי לראות פירוט של החיובים.

תרחיש לדוגמה

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

הדרישות לגבי תוויות

התוויות שמוחלות על בקשה צריכות לעמוד בדרישות הבאות:

• כל בקשה יכולה לכלול כמה תוויות, עד 64 לכל היותר.
• כל תווית צריכה להיות צמד מפתח/ערך.
• האורך המינימלי של המפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
• המפתחות והערכים מכילים רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים.
• החלק המרכזי של התווית צריך להיות ייחודי בתוך בקשה אחת (לדוגמה, {'country':'india'} הוא תקין, אבל {'country':'india','country':'sweden'} לא תקין).
• המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.

תוויות וחיוב

ב-Cloud Translation, אתם יכולים להשתמש בתוויות כדי לארגן עמלות לפי חשבון לחיוב. לא חל שינוי בשימוש בתוויות של Cloud Translation.

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

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

יצירה וניהול של תוויות באמצעות Cloud Translation API

משתמשים ב-Cloud Translation API כדי להוסיף תוויות לבקשה.

REST

בדוגמה הבאה, התוויות {'country':'russia'} ו-{'env':'test'} נוספות לבקשת translateText.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER_OR_ID: המזהה המספרי או האלפאנומרי של פרויקט Google Cloud

ה-method של ה-HTTP וכתובת ה-URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText

תוכן בקשת JSON:

{
  source_language_code: 'en',
  target_language_code: 'ru',
  contents: 'Dr. Watson, come here!',
  labels: {'country':'russia','env':'test'}
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText"

‎PowerShell (Windows)

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

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "translations": [
    {
      "translatedText": "Доктор Ватсон, иди сюда!"
    }
  ]
}

דוח תמחור

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

1. במרכז הבקרה, לוחצים על סמל התפריט (שלושה קווים) בפינה הימנית העליונה ובוחרים באפשרות 'חיוב' מהתפריט הנפתח. אם יש לכם כמה חשבונות לחיוב, יוצג דף שבו תתבקשו לבחור חשבון. לוחצים על 'מעבר לחשבון לחיוב המקושר'.
2. בדף Billing, בוחרים באפשרות Reports (דוחות) בתפריט הניווט הימני.
3. משתמשים במסננים שבתפריט הניווט הימני כדי לבדוק את השימוש בבקשות.