Bayi API'sı sorunlarını giderme

Bu sayfada, Bayi API'si ile ilgili olarak 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 oluşur. 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 postalAddress.countryCode uygun değil.
  • alternateEmail, customerDomain ile aynı alan adında 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 aşağıdaki sorunlardan biri bu hataya 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, yenileme sırasında hesaptaki etkin kullanıcı sayısına eşit sayıda koltuk içerecek şekilde otomatik olarak ayarlanması.
  • İstediğiniz lisans miktarı, 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 bildirin.
  • Yanlış koltuk parametresini artırdınız. FLEX planı için maximumNumberOfSeats parametresini, ANNUAL planı için ise numberOfSeats parametresini artırın.
  • Salt okunur bir parametre olan licensedNumberOfSeats parametresini değiştirmeye çalıştınız.
  • Deneme süresi boyunca müşterilerin maksimum lisans sınırı 10'dur. Ücretsiz deneme aboneliğinden ücretli hizmete geçerek deneme süresini hemen sonlandırabilir, faturalandırmayı başlatabilir ve 10 koltukluk maksimum sınırı kaldırabilirsiniz.

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.

403:usageLimits.dailyLimitExceeded

Bu hata, bu API'ye yapılan çağrılar için günlük kotaya ulaştığınızda oluşur. Bu sorunu çözmek için geri çekilme gecikmesi uygulayın. Daha fazla bilgi için Kullanım sınırları ve kotalar başlıklı makaleyi inceleyin.

Çok sayıda aboneliği almaya çalışıyorsanız subscriptions.list veya customerId parametrelerini belirtmeden subscriptionId yöntemini kullanmayı deneyin. Çağrı 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 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.

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 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ütlü ö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ının olmadığını anlarsınız. Bu sorunu çözmek için geçici bir yönetici kullanıcısı ekleyip tekrar deneyin.

subscriptions.insert yöntemini kullanırken bu hatayla karşılaşırsanız seçilen SKU'yu yeniden satamayacağınız veya gelişmekte olan pazarlardaki müşterilere satamayacağınız anlamına gelir. Bu sorunu çözmek için geçerli hizmet şartlarını kabul edin.

429:usageLimits.quotaExceeded

Bu hata, saniyede sorgu sınırını aştığınızda oluşur. Bu sorunu çözmek için 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 başlıklı makaleyi inceleyin.

Çok sayıda aboneliği almaya çalışıyorsanız subscriptions.list veya customerId parametrelerini belirtmeden subscriptionId yöntemini kullanmayı deneyin. Çağrı 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.