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 aktarıldığında ortaya çıkar.

users.get yöntemini kullanıyorsanız userKey parametresine iletilen 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 değerini kullanın. Gerçek müşterinin alanını kullanmayın. Bir müşterinin ikincil alanları varsa domain parametresinin kullanılması yalnızca ilgili alanda e-posta adresi olan kullanıcıları döndürdüğü için bu parametreyi kullanmanızı öneririz.
  • domain parametresi: Yalnızca gerçek müşterinin alanını kullanın. Google tarafından oluşturulan
    customerId'ı kullanmayın.

403:domainCannotUseApis

Bu hata, müşteriniz Yönetici SDK'si API'sine bayi erişimini devre dışı bıraktığında ortaya çıkar. Bu sorunu çözmek için müşterinizden Yönetici SDK'sine API erişimini 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ışırken 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 ortaya çıkar.

Bu sorunu çözmek için müşterinin bayi sahipliğini doğrulamak amacıyla arama yapmadan önce customers.get yöntemini çağırın veya müşterinizden Yönetici Konsolu'na 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 ortaya çıkar. 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-postası aşağıdakilerden birinde zaten mevcut olduğunda ortaya çıkar:

  • Kartları 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ı alırsanız kullanıcı müşterinin Google Workspace hesabında zaten mevcut demektir. Bu kullanıcıyı hesaba ekleyemezsiniz.

    403 forbidden yanıtı alırsanız birincil e-posta parametresindeki alan, 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. Bu kullanıcının başarıyla eklenmesi için önce müşterinin alanının doğrulanması gerekir.

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

    1. users.insert yöntemini kullanarak geçici bir yönetici kullanıcı oluşturun ve son alan doğrulama adımına geçin.
    2. Alanı doğrularken 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, users.patch veya users.update yöntemlerinden birini kullanarak geçici kullanıcı adını yeniden adlandırın.

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

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

412:limitExceeded

Bu hata, müşteriniz maksimum koltuk sayısına ulaştığında ortaya çıkar. Bu sorunu çözmek için subscriptions.changeSeats yöntemini kullanın ve abonelik planına bağlı olarak aşağıdakileri uygulayın:

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