Bayi API'sı sorunlarını giderme

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çin maximumNumberOfSeats parametresini artırın ve ANNUAL planı için numberOfSeats 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.