הערה: קבוצת המסמכים הזו מיועדת למהדורות Standard,‏ Plus ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

קניית מינויים והקצאת רישיונות ל-Gemini Enterprise

בדף הזה מוסבר איך להירשם ל-Gemini Enterprise ואיך לנהל את רישיונות המשתמשים.

הגדרת הגישה כוללת בדרך כלל את השלבים הבאים:

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

מידע על רישיונות

כדי להיכנס לאפליקציית Gemini Enterprise, למשתמש צריך להיות רישיון. אפשר להקצות רישיונות למשתמשים באופן ידני או אוטומטי.

רישיונות שמוקצים באופן ידני: אפשר להוסיף משתמשים לפי כתובות האימייל שלהם.
רישיונות שמוקצים באופן אוטומטי: אתם יכולים להגדיר מינוי כך ש-Gemini Enterprise יקצה באופן אוטומטי רישיון למשתמש בפעם הראשונה שהוא ניגש ל-Gemini Enterprise או לממשק Gemini Notebook Enterprise.

מידע על מינויים

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

ב-Gemini Enterprise, אפשר לקנות מינוי חודשי או מינוי לשנה. אפשר להגדיר את המינויים האלה לחידוש אוטומטי.

אתם יכולים לרכוש מינויים למהדורות Gemini Enterprise Standard,‏ Gemini Enterprise Plus ו-Gemini Enterprise Pay-as-you-go באמצעותGoogle Cloud המסוף.

מגבלות על מספר המושבים במינוי

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

חשבונות לחיוב בניהול עצמי (או אונליין) וחשבונות לחיוב שנמכרים דרך מפיץ: מוגבלים למקסימום של 25 מושבים לכל חשבון כשמנהלים מינויים באמצעות מסוף Google Cloud .
חשבונות לחיוב בחשבונות שמחויבים בחשבונית (אופליין): מוגבלים לעד 1,000 מושבים לכל חשבון.

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

מידע על מצבי מינוי

מינוי יכול להיות באחד מהסטטוסים הבאים:

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

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

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

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

הערה: מינוי Gemini Enterprise בתשלום לפי שימוש זמין רק לחשבונות עם חיוב חודשי. מידע נוסף זמין במאמר סוגים של חשבונות לחיוב ב-Cloud.

מוודאים שיש לכם את התפקידים וההרשאות הנדרשים ב-IAM:

תפקיד האדמין של Gemini Enterprise.

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

Billing Account Administrator (roles/billing.admin)
Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

לחלופין, כדי לקבל שליטה מפורטת ב-IAM, אפשר להשתמש בתפקיד בהתאמה אישית עם ההרשאות הבאות במקום בתפקיד Billing Account Administrator:

שירות	הרשאות
Discovery Engine	`discoveryengine.billingAccountLicenseConfigs.distribute` `discoveryengine.billingAccountLicenseConfigs.get` `discoveryengine.billingAccountLicenseConfigs.list` `discoveryengine.billingAccountLicenseConfigs.retract` `discoveryengine.licenseConfigs.create` `discoveryengine.licenseConfigs.get` `discoveryengine.licenseConfigs.list` `discoveryengine.licenseConfigs.update` `discoveryengine.projects.get` `discoveryengine.projects.provision` `discoveryengine.projects.reportConsentChange` `discoveryengine.userStores.batchUpdateUserLicenses` `discoveryengine.userStores.listUserLicenses`
רכש צרכני	`consumerprocurement.orders.get` `consumerprocurement.licensePools.assign` `consumerprocurement.licensePools.unassign` `consumerprocurement.licensePools.enumerateLicensedUsers`
מנהל המשאבים	`resourcemanager.projects.get` `resourcemanager.projects.list`
Service Usage	`serviceusage.services.get` `serviceusage.services.list`

רכישת מינוי

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

‫Standard ו-Plus

כדי להירשם למהדורת Gemini Enterprise Standard או Plus, מבצעים את הפעולות הבאות:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול מינויים > יצירת מינוי.
במהדורות Gemini Enterprise Standard או Gemini Enterprise Plus, לוחצים על הרשמה.
מגדירים את פרטי החיוב:
1. בוחרים את החשבון לחיוב מהתפריט הנפתח.
2. מזינים שם מינוי.
3. מזינים את מספר הרישיונות שדרושים למהדורה.
בוחרים את תקופת המינוי.
אם רוצים שהמינוי יתחדש אוטומטית, בוחרים באפשרות חידוש אוטומטי של המינוי.
מגדירים את פרטי ההפצה:
1. בתפריט הנפתח Select a project, בוחרים את הפרויקט.
2. בוחרים Location type למינוי. אם אין צורך לשמור את הנתונים בארצות הברית או באחת ממדינות האיחוד האירופי כדי לעמוד בדרישות של הוראות דין או חוקים, Google ממליצה לבחור באזור גיאוגרפי גלובלי לאחסון נתונים כדי להבטיח זמינות מקסימלית וזמן אחזור נמוך.
לוחצים על יצירה > אישור.

Pay-as-you-go

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

כדי להירשם למהדורת Gemini Enterprise עם תשלום לפי שימוש:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול מינויים > יצירת מינוי.
במהדורת Gemini Enterprise תשלום לפי שימוש, לוחצים על הרשמה.
מגדירים את פרטי החיוב:
1. מזינים שם מינוי.
2. מזינים את מספר הרישיונות שדרושים למהדורה.
מגדירים את פרטי ההפצה:
1. בתפריט הנפתח Select a project, בוחרים את הפרויקט.
2. בוחרים Location type למינוי. אם אין צורך לשמור את הנתונים בארצות הברית או באחת ממדינות האיחוד האירופי כדי לעמוד בדרישות של הוראות דין או חוקים, Google ממליצה לבחור באזור גיאוגרפי גלובלי לאחסון נתונים כדי להבטיח זמינות מקסימלית וזמן אחזור נמוך.
לוחצים על יצירה > אישור.

ניהול מינויים

בקטע הזה מוסבר איך לצפות במינויים ל-Gemini Enterprise, לעדכן אותם, להפיץ אותם ולבטל אותם.

הצגה של פרטי המינוי

כדי לראות את פרטי המינויים שלכם ל-Gemini Enterprise:

המסוף

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול המינויים.
בוחרים את החשבון לחיוב מהתפריט הנפתח.
בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.

REST

כדי לקבל את פרטי המינוי, מריצים את הפקודה הבאה:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer
‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.

פלט לדוגמה

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

עדכון הגדרות המינוי

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

הדרך להוסיף עוד רישיונות משתנה בהתאם לדרך שבה רכשתם את המינוי:

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

הערה: כשמעדכנים את מספר המושבים במינוי במסוף Google Cloud , חלות מגבלות על מספר המושבים בהתאם לסוג החשבון לחיוב (עד 25 מושבים בחשבונות בניהול עצמי (או אונליין) ובחשבונות לחיוב שנמכרים דרך מפיצים, ועד 1,000 מושבים בחשבונות לחיוב שמונפקות בהם חשבוניות (או אופליין)). מידע נוסף זמין במאמר מגבלות על מספר המושבים במינוי.

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

כדי לעדכן את מספר הרישיונות אם רכשתם דרךGoogle Cloud המסוף:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול המינויים.
לוחצים על המינוי שרוצים לעדכן בטבלה Gemini Subscriptions (מינויי Gemini).
לוחצים על עריכה לצד פרטי המינוי.
מעדכנים את מספר הרישיונות או מפעילים או משביתים את החידוש האוטומטי.
לוחצים על שליחה.

ביטול המינוי

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

כדי לבטל את המינוי:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול המינויים.
בטבלה Gemini Subscriptions, לוחצים על שם המינוי כדי לפתוח את דף פרטי המינוי.
לוחצים על Edit.
בחלונית עריכת המינוי, מבטלים את הסימון בתיבת הסימון חידוש אוטומטי של המינוי.
לוחצים על שליחה.

הפצת רישיונות

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

המסוף

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול המינויים.
בוחרים את החשבון לחיוב מהתפריט הנפתח.
בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.
לוחצים על הפצת רישיון בחלק העליון של הדף. תוצג רשימה עם נתוני ההפצה של הרישיונות הקיימים וסטטיסטיקה של המושבים שנותרו והמושבים הכוללים.
כדי להפיץ רישיונות לפרויקט:
1. לוחצים על רשימת הפרויקטים ובוחרים פרויקט. הבורר תומך בהשלמה אוטומטית.
2. הערה: אם לא הפעלתם את Discovery Engine API בפרויקט שנבחר, תופיע תיבת דו-שיח עם בקשה להפעיל אותו.
3. בוחרים מיקום.
4. מזינים את מספר הרישיונות להקצאה.
5. אם רוצים להקצות רישיונות לכמה פרויקטים או מיקומים, חוזרים על השלבים האלה.
לוחצים על שליחה.
בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים ולוחצים על אישור.

REST

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

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer (צרכן השימוש בשירות)
‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
- ‫us לאזור עם מספר אזורים בארה"ב
- ‫eu לאזור עם מספר אזורים באיחוד האירופי
- global למיקום הגלובלי
מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
‫LOCATION: האזור המרובה של מאגר הנתונים: global,‏ us או eu.
‫TARGET_PROJECT_NUMBER: מספר הפרויקט שאליו רוצים להקצות רישיונות.
‫LICENSE_COUNT: מספר הרישיונות להפצה.
‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.
‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה תצורת הרישיון של החשבון לחיוב בפרטי המינוי.
אופציונלי LICENSE_CONFIG_ID: המזהה של הגדרת רישיון קיימת ברמת הפרויקט. אפשר למצוא את המזהה הזה בשדה licenseConfigDistributions כשמציגים את פרטי המינוי.

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

איך משחררים רישיונות לא מוקצים במינוי

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

המסוף

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול המינויים.
בוחרים את החשבון לחיוב מהתפריט הנפתח.
בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.
בחלק העליון של הדף, לוחצים על הקצאת רישיון (הכפתור הזה פותח את טופס הניהול של כל ההקצאות).
ברשימת ההקצאות, מאתרים את השורה של הפרויקט והמיקום שרוצים לבטל את ההקצאה של הרישיונות שלהם.
בוחרים אחת מהפעולות הבאות:
- כדי להקטין את מספר הרישיונות: מקטינים את המספר בשדה להזנת קלט הרישיונות.
- כדי לבטל את ההקצאה של רישיונות באופן מלא: מעבירים את הסמן מעל השורה כדי לחשוף את לחצן המחיקה, ואז לוחצים על מחיקה.
לוחצים על שליחה.
בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים (שבו יפורטו כל הרישיונות שהוחזרו) ולוחצים על אישור.

REST

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

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer (צרכן השימוש בשירות)
‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
- ‫us לאזור עם מספר אזורים בארה"ב
- ‫eu לאזור עם מספר אזורים באיחוד האירופי
- global למיקום הגלובלי
מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
‫LOCATION: האזור המרובה של מאגר הנתונים: global,‏ us או eu.
‫TARGET_PROJECT_NUMBER: מספר הפרויקט שממנו רוצים לבטל את ההקצאה של הרישיונות.
‫LICENSE_COUNT: מספר הרישיונות שרוצים לבטל.
‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.
‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה תצורת הרישיון של החשבון לחיוב בפרטי המינוי.
‫LICENSE_CONFIG_ID: מזהה תצורת הרישיון של תצורת רישיון קיימת ברמת הפרויקט.

טיפול בסיום מוקדם

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

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

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

בתמונה הבאה מוצגת דוגמה להשבתת רישיון בGoogle Cloud מסוף:

דוגמה להשבתת רישיון במסוף Google Cloud

באפשרותך לנהל את רישיונות המשתמשים

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

הצגת רישיונות

כדי לראות את הרישיונות ואת המשתמשים שהוקצו להם:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול משתמשים.
בוחרים את הגדרת מספר אזורים של הרישיון הקיים.

ייצוא נתוני משתמשים

בטבלת המשתמשים במסוף Google Cloud אין תמיכה במיון או בסינון. אם אתם צריכים למיין, לסנן או לנתח את נתוני המשתמשים, אתם יכולים לייצא עד 1,000,000 רשומות משתמשים לקובץ CSV (ערכים מופרדים בפסיקים).

קובץ ה-CSV המיוצא כולל את העמודות הבאות.

שם עמודה	תיאור
`user_principal`	כתובת האימייל של המשתמש.
`license_config`	שם המשאב המלא Google Cloud של המינוי שהוקצה למשתמש (לדוגמה, `projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID`). מזהה תצורת הרישיון תואם למהדורת Gemini Enterprise (לדוגמה, Standard או Plus) שהוקצתה למשתמש.
`assignment_time`	חותמת הזמן (לפי שעון UTC) שבה אדמין הקצה את הרישיון.
`last_login_time`	חותמת הזמן (לפי שעון UTC) שבה המשתמש נכנס לחשבון בפעם האחרונה.
`license_assignment_state`	מצב הקצאת הרישיון. אלה הערכים האפשריים: ‫`ASSIGNED`: למשתמש יש רישיון שהוקצה לו. ‫`NO_LICENSE`: למשתמש אין רישיון כי אדמין לא הקצה לו רישיון או הסיר רישיון קיים. ‫`BLOCKED`: מדיניות או אדמין חוסמים את המשתמש מקבלת רישיון.

כדי לייצא נתוני משתמשים לקובץ CSV:

במסוף Google Cloud , עוברים לדף Gemini Enterprise >‏ Manage users.

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

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

פתרון בעיות שקשורות לייצוא

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

שגיאה	רזולוציה
הכפתור ייצוא כל המשתמשים מוסתר	מוודאים שיש משתמשים שהוקצו להם רישיונות באזור הרב-אזורי שנבחר. אם לא הוקצו משתמשים, הלחצן ייצוא כל המשתמשים לא יופיע.
בקשת הייצוא נכשלת עם שגיאת חריגה ממגבלה	אם רשימת המשתמשים שלכם חורגת ממגבלת הייצוא של מיליון משתמשים, מסוף Google Cloud דוחה את בקשת הייצוא ומציג הודעת שגיאה על חריגה מהמגבלה.
בקשת הייצוא נכשלת עם השגיאה 'ההרשאה נדחתה'	מוודאים שבחשבון שלכם מוגדר התפקיד אדמין של Gemini Enterprise, שכולל את ההרשאה הנדרשת `discoveryengine.userStores.listUserLicenses`.

הקצה רישיונות למשתמשים

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

הוספת משתמשים והקצאת רישיונות באופן אוטומטי

כדי להקצות רישיונות למשתמשים באופן אוטומטי כשהם נכנסים לאפליקציית Gemini Enterprise, מבצעים את הפעולות הבאות:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

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

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

מידע נוסף על מינויים זמין בקטע מידע על מינויים.

הוספת משתמשים והקצאת רישיונות באופן ידני

כדי לתת למשתמשים ספציפיים גישה ל-Gemini Enterprise, אתם יכולים להקצות להם רישיונות באופן ידני ממינוי פעיל.

המסוף

כדי להקצות רישיונות למשתמשים באופן ידני:

נכנסים לדף Gemini Enterprise במסוף Google Cloud .

‫Gemini Enterprise
לוחצים על ניהול משתמשים.
בוחרים את הגדרת מספר אזורים של הרישיון הקיים.
לוחצים על הוספת משתמשים.
בדף הוספת משתמשים:
1. מזינים את כתובות האימייל של המשתמשים. חשוב להשתמש באותה כתובת אימייל שבה הם ישתמשו כדי להיכנס לאפליקציית Gemini Enterprise.
2. בוחרים את המינוי שרוצים להקצות למשתמשים.
3. לוחצים על שליחה.

REST

כדי להקצות רישיונות למשתמשים באופן ידני, מריצים את הפקודה הבאה:

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
- ‫us לאזור עם מספר אזורים בארה"ב
- ‫eu לאזור עם מספר אזורים באיחוד האירופי
- global למיקום הגלובלי
מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
‫USER_EMAIL: כתובת האימייל של המשתמש שרוצים להוסיף לרישיון.
‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
‫SUBSCRIPTION_ID: המזהה של המינוי ל-Gemini Enterprise.

העברת רישיונות ממינויים שתוקפם פג

משתמשים לא יכולים להיכנס ל-Gemini Enterprise אם המינוי פג. יש כמה דרכים להחזיר להם את הגישה להתחברות:

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

העברה אוטומטית של משתמשים למינוי פעיל

כדי להעביר משתמשים באופן אוטומטי למינוי פעיל:

במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

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

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

העברה ידנית של משתמשים למינוי פעיל

כדי להעביר משתמשים באופן ידני למינוי פעיל:

במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

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

רשימת הרישיונות

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

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
- ‫us לאזור עם מספר אזורים בארה"ב
- ‫eu לאזור עם מספר אזורים באיחוד האירופי
- global למיקום הגלובלי
מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu

הסרת משתמשים מרישיון

אפשר להסיר רישיון ממשתמש בכל שלב. כשמסירים רישיון, המשתמש מאבד מיד את הגישה ל-Gemini Enterprise. כדי להסיר משתמשים מרישיון:

המסוף

כדי להסיר משתמשים מרישיון באמצעות מסוף Google Cloud :

במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

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

REST

כדי להסיר משתמשים מרישיון, מריצים את הפקודה הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
- ‫us לאזור עם מספר אזורים בארה"ב
- ‫eu לאזור עם מספר אזורים באיחוד האירופי
- global למיקום הגלובלי
מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
USER_EMAIL: כתובת האימייל של המשתמש שרוצים להסיר מהרישיון.

קניית מינויים והקצאת רישיונות ל-Gemini Enterprise קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מידע על רישיונות

מידע על מינויים

מגבלות על מספר המושבים במינוי

מידע על מצבי מינוי

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

רכישת מינוי

‫Standard ו-Plus

Pay-as-you-go

ניהול מינויים

הצגה של פרטי המינוי

המסוף

REST

עדכון הגדרות המינוי

ביטול המינוי

הפצת רישיונות

המסוף

REST

איך משחררים רישיונות לא מוקצים במינוי

המסוף

REST

טיפול בסיום מוקדם

באפשרותך לנהל את רישיונות המשתמשים

הצגת רישיונות

ייצוא נתוני משתמשים

פתרון בעיות שקשורות לייצוא

הקצה רישיונות למשתמשים

הוספת משתמשים והקצאת רישיונות באופן אוטומטי

הוספת משתמשים והקצאת רישיונות באופן ידני

המסוף

REST

העברת רישיונות ממינויים שתוקפם פג

העברה אוטומטית של משתמשים למינוי פעיל

העברה ידנית של משתמשים למינוי פעיל

רשימת הרישיונות

הסרת משתמשים מרישיון

המסוף

REST

המאמרים הבאים

קניית מינויים והקצאת רישיונות ל-Gemini Enterprise