عیب یابی مشکلات 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

این خطا زمانی رخ می دهد که شما مالک مشتری نیستید یا مشتری شما دسترسی فروشنده به کنسول مدیریت خود را غیرفعال کرده باشد.

برای حل این مشکل، قبل از برقراری تماس با روش customers.get تماس بگیرید تا مالکیت فروشنده مشتری را تأیید کنید یا از مشتری خود بخواهید که دسترسی فروشنده به کنسول مدیریت خود را دوباره فعال کند. برای اطلاعات بیشتر، دسترسی به کنسول مدیریت مشتری را ببینید.

403:usageLimits.accessNotConfigured

این خطا زمانی رخ می دهد که API در پروژه Google Cloud فعال نباشد. برای حل این مشکل، به کنسول Google Cloud بروید و API را فعال کنید. برای اطلاعات بیشتر، فعال کردن Google Workspace APIs را ببینید.

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. از مشتری خود بخواهید به عنوان کاربر موقت وارد سیستم شود و دامنه خود را از طریق کنسول مدیریت تأیید کند.
   3. پس از تایید دامنه، مشتری یا شما می توانید نام کاربری موقت را تغییر نام دهید. می توانید از روش های users.patch یا users.update استفاده کنید.

412:limitExceeded

این خطا زمانی رخ می دهد که مشتری شما به حداکثر ظرفیت صندلی خود رسیده باشد. برای حل این مشکل، از روش subscriptions.changeSeats استفاده کنید و بسته به طرح اشتراک آنها، از موارد زیر استفاده کنید:

• برای FLEXIBLE ، پارامتر maximumNumberOfSeats را افزایش دهید.
• برای ANNUAL ، پارامتر numberOfSeats را افزایش دهید.