אדמינים יכולים להוסיף ולהגדיר כמה אפליקציות של צד שלישי באמצעות קובץ של ערכים מופרדים בפסיקים (CSV). ממסוף Google Admin, אפשר להוריד תבנית CSV ריקה. אפשרות נוספת היא להוריד קובץ CSV עם כל האפליקציות של צד שלישי שכבר נמצאות במסוף Admin, כדי לערוך אותו או להוסיף לו אפליקציות.
לפני שמתחילים
- הגודל המקסימלי של קובץ CSV הוא 10MB.
- כשמעלים את הקובץ, המידע בעמודות Type, Id, Access ו-Org Unit מחליף את המידע הקיים במסוף Admin.
- אם יש מידע שלא רוצים לשנות, אפשר למחוק את העמודה, להשאיר את המידע כמו שהוא או למחוק אותו.
- אם מוחקים את כל המידע מעמודה, אבל משאירים את העמודה בקובץ ה-CSV, המידע הקיים לא יוסר כשמעלים את הקובץ.
- אם אתם לא רוצים לערוך אפליקציה מסוימת, אתם יכולים להשאיר את השורה בגיליון האלקטרוני או להסיר אותה. אם מסירים אפליקציה מהקובץ, האפליקציה לא נמחקת.
הוספה והגדרה של אפליקציות מקובץ CSV
שלב 1: מורידים את קובץ ה-CSV
-
במסוף Google Admin, נכנסים לתפריט
אבטחה שליטה בגישה ובנתונים אמצעי בקרה לממשקי API ניהול הגישה של אפליקציות של צד שלישי.כדי לבצע את המשימה הזו אתם צריכים להיות מחוברים לחשבון בתור סופר-אדמינים.
- (אופציונלי) כדי להגדיר רק אפליקציות שקיבלו גישה לנתונים בחשבון Google, לוחצים על הצגת הרשימה לצד אפליקציות עם גישה.
- לוחצים על עדכון מספר פריטים בו-זמנית של רשימה ובוחרים באחת מהאפשרויות:
- כדי להוריד תבנית CSV ריקה, לוחצים על הורדת תבנית ריקה.
- כדי להוריד קובץ CSV עם אפליקציות של צד שלישי שכבר מופיעות במסוף Admin, לוחצים על הורדת אפליקציות מוגדרות או על הורדת אפליקציות עם גישה. כשההורדה מסתיימת, לוחצים על הורדת CSV. יכול להיות שיהיה צריך ללחוץ קודם על סמל Tasks
.
- פותחים את קובץ ה-CSV באפליקציה של גיליון אלקטרוני, כמו Google Sheets או Microsoft Excel.
בקובץ יש עמודות עם המאפיינים של כל אחת מהאפליקציות שהגדרתם.
שלב 2: מזינים את פרטי האפליקציה ושומרים את הקובץ
- לכל אפליקציה שרוצים להגדיר, מזינים את הפרטים בעמודות בגיליון האלקטרוני:
- (אופציונלי) שם האפליקציה – מזינים את שם האפליקציה. שינויים שאתם מבצעים בשם האפליקציה בקובץ ה-CSV לא מתעדכנים במסוף Admin.
- סוג – מזינים Android, iOS או אפליקציית אינטרנט.
- מזהה – לאפליקציות אינטרנט, מזינים את מזהה הלקוח ב-OAuth שהוקצה לאפליקציה. באפליקציות ל-Android ול-iOS, מזינים את מזהה הלקוח ב-OAuth או את מזהה החבילה שהאפליקציה משתמשת בו ב-Google Play או ב-Apple App Store.
- גישה – מזינים מהימנה, חסומה, מוגבלת, או לא הוגדרה (מבטל את ההגדרה של האפליקציה ביחידה הארגונית שצוינה ב'יחידה ארגונית').
- יחידה ארגונית – מזינים קו נטוי לפנים (/) כדי להחיל את הגדרת הגישה לאפליקציה על כל הדומיין. כדי להחיל הגדרות גישה על יחידות ארגוניות ספציפיות, מוסיפים שורה לגיליון האלקטרוני לכל יחידה ארגונית, וחוזרים על שם האפליקציה, הסוג והמזהה. מזינים את הגדרת הגישה הרצויה, וביחידה ארגונית מזינים את הנתיב והשם המלאים (לדוגמה, '/org_unit_1/sub_unit_1').
- אחרי שממלאים את הגיליון האלקטרוני, שומרים אותו כקובץ CSV (.csv).
שלב 3: העלאת הקובץ
- במסוף Admin, לוחצים על צירוף קובץ CSV. יכול להיות שתצטרכו ללחוץ קודם על עדכון מספר פריטים בו-זמנית.
- מאתרים את קובץ ה-CSV ומצרפים אותו.
- לוחצים על העלאה.
אפשר לבדוק את התקדמות ההעלאה. בסיום התהליך, תקבלו דוח באימייל.
אם יש שגיאה, מזינים את המידע החסר ומעלים את הקובץ שוב. אם יש שגיאת עיבוד, צריך להוריד את קובץ היומן מרשימת המשימות. מידע נוסף זמין בקטע פתרון שגיאות בהמשך הדף.
פתרון שגיאות
שגיאות בהעלאות של קובץ CSV
| שגיאה | הסיבה והפתרון |
|---|---|
| הקובץ ריק | הקובץ לא מכיל מידע. |
| פורמט קובץ שגוי או עמודה לא חוקית: שם העמודה. | העמודות בקובץ צריכות להיות: שם האפליקציה, סוג, מזהה, סטטוס אימות, משתמשים, שירותים מבוקשים, גישה, שירותים מבוקשים עם היקפי הרשאה ויחידה ארגונית. |
| העמודה שם העמודה חסרה. | חסרה עמודה נדרשת. העמודות הנדרשות הן סוג, מזהה, גישה ויחידה ארגונית. |
| שורה nn: שם העמודה ריק | עמודה שנדרש בה מידע ריקה בשורה מסוימת. לדוגמה, אם לא הזנתם את רמת הגישה של האפליקציה, תוצג השגיאה שורה 2: הערך 'גישה' ריק. צריך להוסיף את המידע ולנסות שוב. |
| הגודל המקסימלי של הקובץ הוא 10MB. | קובץ ה-CSV גדול מ-10MB. צריך לפתוח את הקובץ, לפצל את הטבלה לקבצים נפרדים ולשמור כל קובץ בפורמט CSV. חשוב לכלול את השורה של כותרות העמודות בכל קובצי ה-CSV. |
| שורה nn: מספר העמודות שגוי | מספר העמודות לא תואם למספר עמודות הכותרת בשורה. צריך לבדוק את פרטי השורה ולנסות שוב. |
| לא ניתן לקרוא את הקובץ. צריך לבדוק אותו ולנסות שוב. | אירעה שגיאה בקריאת הקובץ. צריך לבדוק את הקובץ ולנסות שוב. |
| לא ניתן לקרוא את הכותרת. צריך לבדוק אותו ולנסות שוב. | הכותרת בקובץ ה-CSV שהועלה לא תקינה. הכותרות בקובץ צריכות להיות: שם האפליקציה, סוג, מזהה, סטטוס האימות, משתמשים, שירותים מבוקשים, גישה, שירותים מבוקשים עם היקפי הרשאה ויחידה ארגונית. צריך לבדוק את הכותרות ולנסות שוב. |
| הקובץ מכיל עמודה כפולה: שם העמודה. | קובץ ה-CSV שהעלית מכיל עמודה כפולה. צריך להסיר את העמודה הכפולה ולנסות שוב. |
| סוג הקובץ לא מתאים. אפשר להעלות רק קובצי CSV. | סוג הקובץ שהועלה הוא לא בפורמט CSV. שומרים את הגרסה המעודכנת כקובץ CSV ומנסים שוב. |
| שורה nn: לא ניתן לנתח | לא הייתה אפשרות לנתח שורה בקובץ ה-CSV. צריך לבדוק את פרטי השורה ולנסות שוב. |
| שורה nn: סוג האפליקציה שגוי | סוג האפליקציה בשורה בקובץ לא תקין. סוגי האפליקציות שמתקבלים הם אפליקציות ל-Android, ל-iOS או לאפליקציית אינטרנט. |
| שורה nn: סטטוס לא תקין | בשורה מסוימת בקובץ יש מידע לא תקין לגבי הגישה. בעמודה 'גישה' צריך להיות כתוב 'מהימנה', 'חסומה' או 'מוגבלת'. צריך לעדכן את העמודה ולנסות שוב. |
| שורה nn: רשומה כפולה | יש לך שורה כפולה. צריך להסיר את השורה הכפולה ולנסות שוב. |
| שורה nn: שגיאה לא ידועה | אירעה שגיאה לא ידועה במהלך ניתוח השורה. צריך לבדוק את פרטי השורה ולנסות שוב. |
שגיאות בקובץ היומן
| שגיאה | הסיבה והפתרון |
|---|---|
| הפעולה נכשלה: אימות | רשומה מכילה תווים לא נתמכים. צריך לבדוק את הקובץ ולנסות שוב. |
| הפעולה נכשלה: שגיאה לא ידועה | אירעה שגיאה זמנית. מעלים שוב את קובץ ה-CSV או מעלים פריטים בקבוצות קטנות יותר. |
| INVALID_APP_IDENTIFIER |
אחד או יותר ממזהי האפליקציות שהזנתם שגויים.
|
| INVALID_ORG_UNIT_PATH | היחידה הארגונית שהזנת לא תקינה. צריך לעדכן את היחידה הארגונית ולנסות שוב. |
| CONFIGURATION_LIMIT_REACHED | הגעתם למגבלה של 15,000 אפליקציות מוגדרות או חרגתם ממנה. המספר הכולל של אפליקציות צד שלישי שאפשר להגדיר (בצובר או בנפרד) הוא 15,000. צריך להסיר את השורות הנוספות ולנסות שוב. |
| FIRST_PARTY_APP_ERROR | מזהה האפליקציה לא שייך לאפליקציית צד שלישי ואי אפשר להגדיר אותו. צריך להסיר את האפליקציה מהקובץ ולנסות שוב. |
Google, Google Workspace וסימנים וסמלי לוגו קשורים הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.