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

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

400:badRequest

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

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

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

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

403:domainCannotUseApis

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

אם אתם מנסים לקבל את מספר המשתמשים המורשים הנוכחיים וקיבלתם את השגיאה הזו, במקום להפעיל את השיטה 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. קוראים ל-method 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.