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