Probleme mit der Reseller API beheben

Auf dieser Seite werden einige häufige Probleme im Zusammenhang mit der Reseller API beschrieben.

400:badRequest

Dieser Fehler tritt auf, wenn das Abo entweder gesperrt oder gekündigt wurde. Weitere Informationen finden Sie unter Abo aktivieren.

400:invalid

Dieser Fehler kann verschiedene Ursachen haben.

Wenn Sie die Methode customers.insert verwenden, ist einer der folgenden Kundenobjektparameter ungültig:

  • postalAddress.postalCode ungültig.
  • postalAddress.countryCode ist nicht berechtigt, Google Workspace weiterzuverkaufen.
  • alternateEmail darf sich nicht in derselben Domain wie customerDomain befinden

Prüfen Sie, ob die erforderlichen Parameter für den Kunden vorhanden und gültig sind, um dieses Problem zu beheben.

Wenn Sie die Methode subscriptions.changeSeats verwenden, könnte einer der folgenden Probleme der Grund dafür sein:

  • Sie können die Anzahl der Plätze für Jahrestarife nicht reduzieren. Sie sollten die Verlängerungseinstellungen ändern. für das Abo wird zum Zeitpunkt der Verlängerung automatisch die Anzahl der aktiven Nutzer des Kontos festgelegt.
  • Der angeforderte Sitzplatzbetrag ist kleiner als die aktuellen Nutzer des Kontos. Teile dem Kunden mit, dass er einen Nutzer entfernen muss, bevor er die Anzahl der Nutzerlizenzen reduzieren kann.
  • Sie haben den falschen Parameter für die Anzahl der Nutzerlizenzen erhöht. Erhöhen Sie für den Tarif FLEX den Parameter maximumNumberOfSeats und für den Tarif ANNUAL den Parameter numberOfSeats.
  • Sie haben versucht, den schreibgeschützten Parameter licensedNumberOfSeats zu ändern.
  • Während des Testzeitraums gilt für Kunden eine maximale Anzahl von 10 Nutzerlizenzen. Starten Sie einen kostenpflichtigen Dienst über ein kostenloses Probeabo, um den Testzeitraum sofort zu beenden, die Abrechnung zu starten und die maximale Anzahl von 10 Lizenzen zu entfernen.

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Kunde sind oder der Kunde den Reseller-Zugriff auf seine Admin-Konsole deaktiviert hat.

403:usageLimits.dailyLimitExceeded

Dieser Fehler tritt auf, wenn Sie das Tageskontingent für Aufrufe an diese API erreicht haben. Implementieren Sie eine Backoff-Verzögerung, um dieses Problem zu beheben. Weitere Informationen finden Sie unter Nutzungslimits und Kontingente.

Wenn Sie viele Abos abrufen möchten, verwenden Sie die Methode subscriptions.list, ohne die Parameter customerId oder subscriptionId anzugeben. Sie können maximal 100 Abos pro Aufruf zurückgeben. Verwenden Sie den Parameter pageToken, um weiterhin alle Abos unter einem Reseller-Konto abzurufen.

403:usageLimits.accessNotConfigured

Dieser Fehler tritt auf, wenn die API im Google Cloud-Projekt nicht aktiviert ist. Rufen Sie die Google Cloud Console auf und aktivieren Sie die API, um dieses Problem zu beheben. Weitere Informationen finden Sie unter Google Workspace APIs aktivieren.

404:notFound

Wenn Sie die Methode customers.get verwenden, gibt dieser Fehler an, dass der Kunde oder die Domain für kein Google Workspace-Konto vorhanden ist und die Domain verfügbar ist.

412:conditionNotMet

Dieser Fehler wird durch verschiedene Probleme verursacht.

Wenn dieser Fehler bei Verwendung der Methode subscriptions.changeRenewalSettings auftritt, sollten Sie darauf achten, dass Sie diese Methode nur für die folgenden Zusicherungstarife aufrufen:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Wenn dieser Fehler bei der Verwendung der Methode subscriptions.delete auftritt, ist im Google Workspace-Konto kein Administrator vorhanden. Fügen Sie einen temporären Administrator hinzu und versuchen Sie es noch einmal.

Wenn dieser Fehler bei Verwendung der Methode subscriptions.insert auftritt, bedeutet dies, dass Sie die ausgewählte SKU entweder nicht weiterverkaufen oder an Schwellenkunden gehen können. Akzeptieren Sie die entsprechenden Nutzungsbedingungen, um das Problem zu beheben.

429:usageLimits.quotaExceeded

Dieser Fehler tritt auf, wenn Sie das Limit für Abfragen pro Sekunde überschreiten. Implementieren Sie eine Backoff-Wiederholungsstrategie oder Cache-Ergebnisse, um weniger API-Aufrufe durchzuführen, um dieses Problem zu beheben. Weitere Informationen finden Sie unter Nutzungslimits und Kontingente.

Wenn Sie viele Abos abrufen möchten, verwenden Sie die Methode subscriptions.list, ohne die Parameter customerId oder subscriptionId anzugeben. Sie können maximal 100 Abos pro Aufruf zurückgeben. Verwenden Sie den Parameter pageToken, um weiterhin alle Abos unter einem Reseller-Konto abzurufen.