אדמינים יכולים להוסיף ולהגדיר כמה אפליקציות של צד שלישי באמצעות קובץ של ערכים מופרדים בפסיקים (CSV). במסוף Google Admin, אתם יכולים להוריד תבנית CSV ריקה. אפשר גם להוריד קובץ CSV עם כל האפליקציות של הצד השלישי שכבר נמצאות במסוף Admin, כדי לערוך אותן או להוסיף להן אפליקציות.
לפני שמתחילים
- קובץ CSV יכול להיות בגודל של עד 10MB.
- כשמעלים את הקובץ, המידע בעמודות "סוג", "מזהה", "גישה" ו"יחידה ארגונית" מחליף את המידע הקיים במסוף 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 שהעלית יש כותרת לא תקינה. הכותרות בקובץ צריכות להיות: שם האפליקציה, סוג, מזהה, סטטוס אימות, משתמשים, שירותים מבוקשים, גישה, שירותים מבוקשים עם היקפי הרשאות ויחידה ארגונית. צריך לבדוק את הכותרות ולנסות שוב. |
| הקובץ מכיל 2 עמודות בשם: שם העמודה. | קובץ ה-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. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.