Bayi API'sı sorunlarını giderme

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ın hesaptaki etkin kullanıcı sayısına eşit olacak şekilde otomatik olarak ayarlanması (yenileme sırasında)
  • İstediğiniz lisans sayısı, hesaptaki mevcut kullanıcı sayısından az. Müşteriye, lisans sayısını düşürmeden önce 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üş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ı ekleyip 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 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.