בדף הזה מתוארות כמה בעיות נפוצות שעשויות להופיע בקשר ל-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).
כדי לפתור את הבעיה:
קוראים ל-method
users.get
.אם קיבלת את התשובה
200
, אז המשתמש כבר קיים בחשבון Google Workspace של הלקוח. לא ניתן להוסיף את המשתמש הזה לחשבון.אם קיבלת את התשובה
403 forbidden
, סימן שהדומיין בפרמטר של האימייל הראשי הוא לא לקוח שקנה דרך מפיץ או שכתובת האימייל הראשית כבר שימשה למוצר אחר של Google, וצריך לאמת את הדומיין של הלקוח לפני שאפשר יהיה להוסיף את המשתמש הזה.אם אתם יכולים לאמת את הדומיין של הלקוח, צריך לבצע את הפעולות הבאות:
- יוצרים משתמש עם הרשאת אדמין זמנית באמצעות
השיטה
users.insert
וממשיכים את ניהול התצורה עד לשלב הסופי של אימות הדומיין. - כשמאמתים את הדומיין, מוסיפים את המשתמשים הזמניים לפרמטר
owners[]
בגוף הבקשה עבור הקריאה ל-webResource.insert
. אפשר לבצע את השיחה הזו עד לקבלת תשובה של200
. - אחרי אימות הדומיין, משנים את השם של שם המשתמש הזמני באמצעות השיטות
users.patch
אוusers.update
.
- יוצרים משתמש עם הרשאת אדמין זמנית באמצעות
השיטה
אם אתם לא יכולים לאמת את הדומיין של הלקוח, צריך לבצע את הפעולות הבאות:
- יוצרים משתמש עם הרשאת אדמין זמנית באמצעות השיטה
users.insert
. - בקשו מהלקוח להיכנס למערכת בתור משתמש זמני ולאמת את הדומיין שלו דרך מסוף Admin.
- אחרי אימות הדומיין אפשר לשנות את השם של שם המשתמש הזמני
או של הלקוח. אפשר להשתמש בשיטה
users.patch
או בשיטהusers.update
.
- יוצרים משתמש עם הרשאת אדמין זמנית באמצעות השיטה
412:limitExceeded
השגיאה הזו מתקבלת כשהלקוח הגיע למגבלת העמדות. כדי לפתור את הבעיה צריך להשתמש בשיטה subscriptions.changeSeats
, ובהתאם לתוכנית המנויים של הלקוח, לבצע את הפעולות הבאות:
- עבור
FLEXIBLE
, יש להגדיל את הפרמטרmaximumNumberOfSeats
. - עבור
ANNUAL
, יש להגדיל את הפרמטרnumberOfSeats
.