Probleme mit der Reseller API beheben

Auf dieser Seite werden einige häufige Probleme beschrieben, die im Zusammenhang mit der Reseller API auftreten können.

400:badRequest

Dieser Fehler tritt auf, wenn das Abo entweder gesperrt oder gekündigt wird. Weitere Informationen findest du unter Abo aktivieren.

400:invalid

Dieser Fehler kann verschiedene Ursachen haben.

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

  • postalAddress.postalCode ungültig.
  • postalAddress.countryCode ist nicht für den Weiterverkauf von Google Workspace berechtigt.
  • alternateEmail darf sich nicht in derselben Domain wie customerDomain befinden

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

Wenn Sie die Methode subscriptions.changeSeats verwenden, kann dieser Fehler eines der folgenden Probleme verursacht haben:

  • Bei Jahresmitgliedschaften können Nutzerlizenzen nicht reduziert werden. Ändern Sie gegebenenfalls die Verlängerungseinstellungen. für das Abo, die (zum Zeitpunkt der Verlängerung) automatisch Lizenzen festgelegt werden, die der Anzahl der aktiven Nutzer im Konto entsprechen.
  • Die von Ihnen angeforderten Nutzerlizenzen sind niedriger als die Anzahl der aktuellen Nutzer des Kontos. Informiere den Kunden, dass er einen Nutzer entfernen muss, bevor er die Anzahl der Nutzerlizenzen verringern kann.
  • Sie haben den falschen Parameter für die Sitzplatzanzahl erhöht. Erhöhen Sie für den Plan FLEX den Parameter maximumNumberOfSeats und für den Plan ANNUAL den Parameter numberOfSeats.
  • Sie haben versucht, den schreibgeschützten Parameter licensedNumberOfSeats zu ändern.
  • Während des Testzeitraums können Kunden maximal 10 Lizenzen nutzen. Starten Sie über ein kostenloses Probeabo einen kostenpflichtigen Dienst, 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 der Kunde nicht Ihnen gehört oder Ihr 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 du versuchst, viele Abos abzurufen, kannst du die Methode subscriptions.list verwenden, ohne die Parameter customerId oder subscriptionId anzugeben. Pro Aufruf können maximal 100 Abos zurückgegeben werden. Verwenden Sie den Parameter pageToken, um alle Abos unter einem Reseller-Konto abzurufen.

403:usageLimits.accessNotConfigured

Dieser Fehler tritt auf, wenn die API im Google Cloud-Projekt nicht aktiviert ist. Aktivieren Sie in der Google Cloud Console 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, bedeutet dieser Fehler, 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 eine Reihe verschiedener Probleme verursacht.

Wenn dieser Fehler bei der Verwendung der Methode subscriptions.changeRenewalSettings auftritt, achte darauf, dass du diese Methode nur bei den folgenden Tarifen für Zusicherungen aufrufst:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

Wenn dieser Fehler bei der Verwendung der Methode subscriptions.insert auftritt, kannst du entweder die ausgewählte Artikelnummer nicht weiterverkaufen oder an den Kunden in einem aufstrebenden Marktsegment. Akzeptieren Sie die geltenden Nutzungsbedingungen, um dieses Problem zu beheben.

429:usageLimits.quotaExceeded

Dieser Fehler tritt auf, wenn Sie die Begrenzung der Anzahl der Abfragen pro Sekunde überschritten haben. Um dieses Problem zu beheben, sollten Sie eine Backoff-Wiederholungsstrategie implementieren oder Ergebnisse im Cache speichern, um weniger API-Aufrufe durchzuführen. Weitere Informationen finden Sie unter Nutzungslimits und Kontingente.

Wenn du versuchst, viele Abos abzurufen, kannst du die Methode subscriptions.list verwenden, ohne die Parameter customerId oder subscriptionId anzugeben. Pro Aufruf können maximal 100 Abos zurückgegeben werden. Verwenden Sie den Parameter pageToken, um alle Abos unter einem Reseller-Konto abzurufen.