Bu sayfada, Bayi API'si ile ilgili karşılaşabileceğiniz bazı yaygın sorunlar açıklanmaktadır.
400:badRequest
Bu hata, abonelik askıya alındığında veya iptal edildiğinde ortaya çıkar. Daha fazla bilgi için Aboneliği etkinleştirme başlıklı makaleyi inceleyin.
400:invalid
Bu hata çeşitli nedenlerden kaynaklanabilir.
customers.insert
yöntemini kullanıyorsanız aşağıdaki müşteri nesnesi parametrelerinden biri geçersizdir:
- Geçersiz
postalAddress.postalCode
. - Google Workspace'i yeniden satmak için uygun değil
postalAddress.countryCode
. alternateEmail
,customerDomain
ile aynı alanda olamaz
Bu sorunu çözmek için gerekli parametrelerin mevcut olduğunu ve müşteri için 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üşünebilirsiniz. aboneliğin, koltuk sayısını hesabın etkin kullanıcı sayısına eşit olacak şekilde otomatik olarak (yenileme sırasında) ayarlanması
- İstediğiniz lisans sayısı, hesaptaki mevcut kullanıcı sayısından az. Müşteriye, lisans sayısını azaltmadan önce bir kullanıcıyı kaldırması gerektiğini bildirin.
- Yanlış koltuk parametresini artırdınız.
FLEX
planı içinmaximumNumberOfSeats
parametresini,ANNUAL
planı için isenumberOfSeats
parametresini artırın. - Salt okunur bir parametre olan
licensedNumberOfSeats
parametresini değiştirmeye çalıştınız. - Deneme süresi boyunca müşteriler için maksimum lisans sayısı sınırı 10'dur. Deneme süresini hemen sonlandırmak, faturalandırmaya başlamak ve 10 koltuklı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 Konsolu'na bayi erişimini devre dışı bıraktığında ortaya çıkar.
403:usageLimits.dailyLimitExceeded
Bu hata, bu API'ye yapılan çağrılar için günlük kotaya ulaştığınızda ortaya çıkar. Bu sorunu çözmek için geri çekilme gecikmesi uygulayın. Daha fazla bilgi için Kullanım sınırları ve kotalar bölümüne bakın.
Birçok aboneliği almaya çalışıyorsanız customerId
veya subscriptionId
parametrelerini belirtmeden subscriptions.list
yöntemini kullanabilirsiniz. Arama başına en fazla 100 abonelik döndürebilirsiniz. Bir bayi hesabı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 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.
404:notFound
customers.get
yöntemi kullanıldığında bu hata, müşterinin veya alanın herhangi bir Google Workspace hesabında bulunmadığı ve alanın kullanılabilir olduğu anlamına gelir.
412:conditionNotMet
Bu hata çeşitli sorunlardan kaynaklanır.
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ı olmadığı anlamına gelir. Bu sorunu çözmek için geçici bir yönetici kullanıcı ekleyin ve tekrar deneyin.
subscriptions.insert
yöntemini kullanırken bu hatayla karşılaşırsanız seçili SKU'yu veya gelişmekte olan pazardaki müşteriye yeniden satamazsınız. 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 ortaya çıkar. Bu sorunu çözmek için bir geri almayı yeniden deneme stratejisi uygulayın veya daha az API çağrısı yapmak için sonuçları önbelleğe alın. Daha fazla bilgi için Kullanım sınırları ve kotalar bölümüne bakın.
Birçok aboneliği almaya çalışıyorsanız customerId
veya subscriptionId
parametrelerini belirtmeden subscriptions.list
yöntemini kullanabilirsiniz. Arama başına en fazla 100 abonelik döndürebilirsiniz. Bir bayi hesabındaki tüm abonelikleri almaya devam etmek için pageToken
parametresini kullanın.