פתרון בעיות ב-Directory API

בדף הזה מתוארות כמה בעיות נפוצות שבהן אתם עשויים להיתקל, Directory API כמפיץ.

400:badRequest

השגיאה הזו מתרחשת כשמעבירים ערך פרמטר שגוי ל-method.

אם משתמשים בשיטה users.get, צריך לוודא שהערך שהועבר אל userKey הוא כתובת האימייל הראשית של המשתמש, כתובת האימייל החלופית או מזהה משתמש ייחודי.

אם משתמשים בשיטה users.list, צריך לבדוק את הפרמטרים הבאים:

• הפרמטר customer: יש להשתמש רק בפרמטר customerId שנוצר על ידי Google. אין להשתמש בדומיין של הלקוח בפועל. מומלץ להשתמש כי אם ללקוח יש דומיינים משניים, נעשה שימוש ברכיב domain הפרמטר מחזיר רק משתמשים עם כתובות אימייל בדומיין המסוים הזה.
• הפרמטר domain: יש להשתמש רק בדומיין של הלקוח בפועל. אין להשתמש ב-
  customerId ש-Google יצרה.

403:domainCannotUseApis

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

אם אתם מנסים לקבל את מספר המשתמשים בעלי הרישיון הנוכחי, וקיבלתם את במקום לקרוא ל-method users.list, השתמשו בשדה licensedNumberOfSeats משאב המינויים.

403:forbidden

השגיאה הזו מתקבלת אם הלקוח לא מוגדר כבעלים או שהלקוח השבית גישת המפיץ למסוף Admin שלו.

כדי לפתור את הבעיה, אפשר לקרוא לפונקציה אמצעי תשלום אחד (customers.get) לפני ביצוע שיחות לאימות הבעלות של המפיץ על הלקוח או פנייה כדי להפעיל מחדש את גישת המפיץ למסוף Admin שלו. לקבלת מידע נוסף מידע נוסף, ראה גישה למסוף Admin של לקוח.

403:usageLimits.accessNotConfigured

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

409:duplicate

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

• החשבון הנוכחי ב-Google Workspace שאליו ניסית להוסיף אותם.
• מוצר אחר של Google (לא Google Workspace).

כדי לפתור את הבעיה:

1. מפעילים את השיטה users.get.

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

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

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

   1. ליצור מנהל מערכת זמני באמצעות אמצעי תשלום אחד (users.insert) ולהמשיך להקצות הרשאות עד לשלב הסופי של אימות הדומיין.
   2. כשמאמתים את הדומיין, צריך להוסיף את המשתמשים הזמניים אל owners[] של גוף הבקשה שיחת webResource.insert. ניתן לבצע את השיחה עד שתתקבל תשובה מסוג 200.
   3. לאחר אימות הדומיין, שינוי השם של שם המשתמש הזמני באמצעות או users.patch או users.update שיטות.

3. אם לא מצליחים לאמת את הדומיין של הלקוח:

   1. ליצור מנהל מערכת זמני באמצעות השיטה users.insert.
   2. צריך לבקש מהלקוח להיכנס בתור משתמש זמני ולאמת את זהותו באמצעות מסוף Admin.
   3. אחרי אימות הדומיין, הלקוח או הלקוח יכולים לשנות את השם של שם משתמש זמני. אפשר להשתמש users.patch או users.update שיטות.

412:limitExceeded

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

• עבור FLEXIBLE, מגדילים את הפרמטר maximumNumberOfSeats.
• עבור ANNUAL, מגדילים את הפרמטר numberOfSeats.