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

412:limitExceeded

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

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