Directory API sorunlarını giderme

Bu sayfada, bayi olarak Directory API ile ilgili karşılaşabileceğiniz bazı yaygın sorunlar açıklanmaktadır.

400:badRequest

Bu hata, yönteme yanlış bir parametre değeri iletildiğinde oluşur.

users.get yöntemini kullanıyorsanız userKey parametresine aktarılan değerin kullanıcının birincil e-posta adresi, takma ad e-posta adresi veya benzersiz kullanıcı kimliği olduğundan emin olun.

users.list yöntemini kullanıyorsanız aşağıdaki parametreleri doğrulayın:

  • customer parametresi: Yalnızca Google tarafından oluşturulan customerId parametresini kullanın. Gerçek müşteri alanını kullanmayın. Bu parametreyi kullanmanızı öneririz. Çünkü bir müşterinin ikincil alanları varsa domain parametresinin kullanılması yalnızca söz konusu alan adında e-posta adresleri olan kullanıcıları döndürür.
  • domain parametresi: Yalnızca müşterinin gerçek alanını kullanın. Google tarafından oluşturulan
    customerId kullanmayın.

403:domainCannotUseApis

Bu hata, müşteriniz Yönetici SDK'sı API'sine bayi erişimini devre dışı bıraktığında oluşur. Bu sorunu çözmek için müşterinizden Yönetici SDK'sı API'sine erişimi yeniden etkinleştirmesini isteyin. Daha fazla bilgi için API erişimini kontrol etme başlıklı makaleyi inceleyin.

Mevcut lisanslı kullanıcıların sayısını almaya çalışıyorsanız ve bu hatayı alıyorsanız users.list yöntemini çağırmak yerine abonelik kaynağındaki licensedNumberOfSeats alanını kullanın.

403:forbidden

Bu hata, müşterinin sahibi olmadığınızda veya müşteriniz Yönetici Konsolu'na bayi erişimini devre dışı bıraktığında oluşur.

Bu sorunu çözmek için müşterinin bayilik sahipliğini doğrulamak üzere arama yapmadan önce customers.get yöntemini çağırın veya müşterinizden Yönetici Konsolu'nda bayi erişimini yeniden etkinleştirmesini isteyin. Daha fazla bilgi için Müşterinin Yönetici Konsolu'na erişme başlıklı makaleyi inceleyin.

403:usageLimits.accessNotConfigured

Bu hata, API Google Cloud projesinde etkinleştirilmediğinde oluşur. Bu sorunu çözmek için Google Cloud Console'a gidip API'yi etkinleştirin. Daha fazla bilgi için Google Workspace API'lerini etkinleştirme başlıklı makaleyi inceleyin.

409:duplicate

Bu hata, yeni bir kullanıcı eklemeye çalışırken müşterinin birincil e-posta adresinin aşağıdakilerden birinde zaten mevcut olması durumunda oluşur:

  • Kullanıcıları eklemeye çalıştığınız mevcut Google Workspace hesabı.
  • Başka bir Google ürünü (Google Workspace değil).

Bu sorunu çözmek için aşağıdakileri yapın:

  1. users.get yöntemini çağırın.

    200 yanıtını alırsanız kullanıcı, müşterinin Google Workspace Hesabı'nda zaten vardır. Bu kullanıcı hesaba eklenemez.

    403 forbidden yanıtını alırsanız birincil e-posta parametresindeki alan adı yeniden satılan bir müşteri değildir veya birincil e-posta daha önce farklı bir Google ürünü için kullanılmıştır ve bu kullanıcının başarıyla eklenebilmesi için önce müşterinin alan adının doğrulanması gerekir.

  2. Müşterinin alanını doğrulayabiliyorsanız şunları yapın:

    1. users.insert yöntemini kullanarak geçici bir yönetici kullanıcısı oluşturun ve son alan doğrulama adımına kadar sağlama işlemine devam edin.
    2. Alan doğrulanırken geçici kullanıcıları webResource.insert çağrısı için istek gövdesinin owners[] parametresine ekleyin. 200 yanıtı alana kadar bu aramayı yapın.
    3. Alan doğrulandıktan sonra geçici kullanıcı adını users.patch veya users.update yöntemlerini kullanarak yeniden adlandırın.

  3. Müşterinin alanını doğrulayamıyorsanız şunları yapın:

    1. users.insert yöntemini kullanarak geçici bir yönetici kullanıcısı oluşturun.
    2. Müşterinizin geçici kullanıcı olarak oturum açmasını ve Yönetici Konsolu'nu kullanarak alanını doğrulamasını sağlayın.
    3. Alan doğrulandıktan sonra geçici kullanıcı adını müşteri veya siz yeniden adlandırabilirsiniz. users.patch veya users.update yöntemlerinden birini kullanabilirsiniz.

412:limitExceeded

Bu hata, müşteriniz maksimum lisans sınırına ulaştığında oluşur. Bu sorunu çözmek için subscriptions.changeSeats yöntemini kullanın ve abonelik planına bağlı olarak aşağıdakilerden yararlanın:

  • FLEXIBLE için maximumNumberOfSeats parametresini artırın.
  • ANNUAL için numberOfSeats parametresini artırın.