Bu sayfada, Bayi API'siyle ilgili olarak sıklıkla karşılaşabileceğiniz bazı sorunlar açıklanmaktadır.
400:badRequest
Bu hata, abonelik askıya alındığında veya iptal edildiğinde meydana gelir. Daha fazla bilgi edinmek için Aboneliği etkinleştirme başlıklı makaleyi inceleyin.
400:invalid
Bu hata birçok farklı nedenden kaynaklanabilir.
customers.insert
yöntemini kullanıyorsanız aşağıdaki müşteri nesnesi parametrelerinden biri geçersizdir:
- Geçersiz
postalAddress.postalCode
. postalAddress.countryCode
, Google Workspace bayiliği için uygun değil.alternateEmail
,customerDomain
ile aynı alanda olamaz
Bu sorunu çözmek üzere müşteri için gerekli parametrelerin mevcut ve geçerli olduğunu doğrulayın.
subscriptions.changeSeats
yöntemini kullanıyorsanız bu hataya aşağıdaki sorunlardan biri neden olmuş olabilir:
- Yıllık plan türlerinde lisans sayısını azaltamazsınız. Yenileme ayarlarını değiştirmeyi düşünün. Bu durumda, aboneliğin hesaptaki etkin kullanıcı sayısına eşit lisans sayısı otomatik olarak ayarlanmasına (yenileme sırasında) eşit olur.
- İstediğiniz lisans tutarı, hesaptaki mevcut kullanıcı sayısından az. Müşteriye, lisans sayısını azaltabilmesi için bir kullanıcıyı kaldırması gerektiğini söyleyin.
- Yanlış lisans parametresini artırdınız.
FLEX
planı içinmaximumNumberOfSeats
parametresini artırın veANNUAL
planı içinnumberOfSeats
parametresini artırın. - Salt okunur bir parametre olan
licensedNumberOfSeats
parametresini değiştirmeye çalıştınız. - Deneme süresi boyunca müşterilere en fazla 10 lisans sınırı vardır. Deneme süresini hemen sona erdirmek, faturalandırmayı başlatmak ve 10 lisanslık maksimum sınırı kaldırmak için ücretsiz deneme aboneliğinden ücretli bir hizmet başlatın.
403:forbidden
Bu hata, müşterinin sahibi olmadığınızda veya müşteriniz Yönetici konsoluna bayi erişimini devre dışı bıraktığında oluşur.
403:usageLimits.dailyLimitExceeded
Bu hata, bu API'ye yapılan çağrılar için günlük kotaya ulaştığınızda meydana gelir. Bu sorunu çözmek için geri yükleme gecikmesi uygulayın. Daha fazla bilgi edinmek için Kullanım sınırları ve kotalar bölümünü inceleyin.
Çok sayıda abonelik almaya çalışıyorsanız subscriptions.list
yöntemini, customerId
veya subscriptionId
parametrelerini belirtmeden kullanabilirsiniz. Arama başına en fazla 100 abonelik döndürebilirsiniz. Bir bayi hesabı altındaki tüm abonelikleri almaya devam etmek için pageToken
parametresini kullanın.
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 edinmek için Google Workspace API'lerini etkinleştirme bölümüne bakın.
404:notFound
customers.get
yöntemi kullanılırken bu hata, müşterinin veya alanın herhangi bir Google Workspace hesabı için mevcut olmadığı ve alanın kullanılabilir olduğu anlamına gelir.
412:conditionNotMet
Bu hataya birçok farklı sorun neden olur.
subscriptions.changeRenewalSettings
yöntemini kullanırken bu hatayla karşılaşırsanız bu yöntemi yalnızca aşağıdaki taahhüt ödeme planlarında çağırdığınızdan emin olun:
ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY
subscriptions.delete
yöntemini kullanırken bu hatayla karşılaşırsanız Google Workspace hesabında yönetici kullanıcı yoktur. Bu sorunu çözmek için geçici bir yönetici kullanıcı ekleyip tekrar deneyin.
subscriptions.insert
yöntemini kullanırken bu hatayla karşılaşmanız, seçilen SKU'yu veya gelişmekte olan pazardaki müşterilere yeniden satamayacağınız anlamına gelir. Bu sorunu çözmek için geçerli hizmet şartlarını kabul edin.
429:usageLimits.quotaExceeded
Bu hata, saniye başına sorgu sınırını aştığınızda oluşur. Bu sorunu çözmek için bir geri yükleme yeniden deneme stratejisi uygulayın veya daha az API çağrısı yapmak için sonuçları önbelleğe alın. Daha fazla bilgi edinmek için Kullanım sınırları ve kotalar bölümünü inceleyin.
Çok sayıda abonelik almaya çalışıyorsanız subscriptions.list
yöntemini, customerId
veya subscriptionId
parametrelerini belirtmeden kullanabilirsiniz. Arama başına en fazla 100 abonelik döndürebilirsiniz. Bir bayi hesabı altındaki tüm abonelikleri almaya devam etmek için pageToken
parametresini kullanın.