פתרון בעיות ב-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. מידע נוסף זמין במאמר שליטה בגישה ל-API.

אם אתם מנסים לקבל את מספר המשתמשים הקיימים עם רישיון ומופיעה הודעת השגיאה הזו, במקום להפעיל את השיטה users.list, השתמשו בשדה licensedNumberOfSeats במשאב המינוי.

403:forbidden

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

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

403:usageLimits.accessNotConfigured

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

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. אחרי האימות של הדומיין, הלקוח או אתם תוכלו לשנות את שם המשתמש הזמני. אפשר להשתמש ב-method‏ users.patch או ב-method‏ users.update.

412:limitExceeded

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

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