عیب یابی مشکلات Directory API

این صفحه برخی از مشکلات رایجی را که ممکن است به عنوان نماینده فروش در رابطه با API دایرکتوری با آنها مواجه شوید، شرح می‌دهد.

400:badRequest

این خطا زمانی رخ می‌دهد که مقدار پارامتر نادرستی به متد ارسال شود.

اگر از متد users.get استفاده می‌کنید، بررسی کنید که مقداری که به پارامتر userKey ارسال می‌شود، آدرس ایمیل اصلی کاربر، آدرس ایمیل مستعار یا شناسه کاربری منحصر به فرد او باشد.

اگر از متد users.list استفاده می‌کنید، پارامترهای زیر را بررسی کنید:

  • پارامتر customer : فقط از customerId تولید شده توسط گوگل استفاده کنید. از دامنه واقعی مشتری استفاده نکنید. ما استفاده از این پارامتر را توصیه می‌کنیم زیرا اگر مشتری دامنه‌های ثانویه داشته باشد، استفاده از پارامتر domain فقط کاربرانی را که آدرس ایمیل آنها در آن دامنه خاص است، برمی‌گرداند.
  • پارامتر domain : فقط از دامنه واقعی مشتری استفاده کنید. از
    customerId که توسط گوگل تولید شده است.

403:domainCannotUseApis

این خطا زمانی رخ می‌دهد که مشتری شما دسترسی نماینده فروش به رابط برنامه‌نویسی نرم‌افزار مدیریت (Admin SDK API) را غیرفعال کرده باشد. برای حل این مشکل، از مشتری خود بخواهید که دسترسی به رابط برنامه‌نویسی نرم‌افزار مدیریت (Admin SDK API) را دوباره فعال کند. برای اطلاعات بیشتر، به بخش دسترسی به رابط برنامه‌نویسی نرم‌افزار مدیریت (Control API access ) مراجعه کنید.

اگر می‌خواهید تعداد کاربران دارای مجوز فعلی را بدست آورید و با این خطا مواجه می‌شوید، به جای فراخوانی متد users.list ، از فیلد licensedNumberOfSeats از منبع subscription استفاده کنید.

403:forbidden

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

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

403:usageLimits.accessNotConfigured

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

409:duplicate

این خطا زمانی رخ می‌دهد که می‌خواهید یک کاربر جدید اضافه کنید، اما ایمیل اصلی مشتری از قبل در یکی از موارد زیر وجود دارد:

  • حساب فعلی Google Workspace که می‌خواهید آنها را به آن اضافه کنید.
  • یکی دیگر از محصولات گوگل (نه گوگل ورک اسپیس).

برای حل این مشکل، موارد زیر را انجام دهید:

  1. متد users.get را فراخوانی کنید.

    اگر پاسخ 200 دریافت کردید، یعنی کاربر از قبل در حساب Google Workspace مشتری وجود دارد. شما نمی‌توانید این کاربر را به حساب اضافه کنید.

    اگر با 403 forbidden مواجه شدید، یا دامنه موجود در پارامتر ایمیل اصلی، دامنه‌ی مشتریِ فروخته‌شده نیست یا ایمیل اصلی قبلاً برای محصول دیگری از گوگل استفاده شده است و قبل از اینکه این کاربر با موفقیت اضافه شود، ابتدا باید دامنه‌ی مشتری تأیید شود.

  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 را افزایش دهید.