Probleme mit der Reseller API beheben

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

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 aus verschiedenen Gründen auftreten.

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

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

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

Wenn Sie die subscriptions.changeSeats-Methode verwenden, kann dieser Fehler durch eines der folgenden Probleme verursacht worden sein:

  • Sie können die Anzahl der Lizenzen für Jahrestarife nicht reduzieren. Ändern Sie die Verlängerungseinstellungen. für das Abo beim Verlängern automatisch die Anzahl der Lizenzen auf die Anzahl der aktiven Nutzer im Konto festzulegen.
  • Die von Ihnen angeforderte Anzahl an Lizenzen ist geringer als die aktuelle Anzahl der Nutzer im Konto. Teile dem Kunden mit, dass er einen Nutzer entfernen muss, bevor er die Anzahl der Lizenzen verringern kann.
  • Sie haben den falschen Sitzparameter 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 Parameter licensedNumberOfSeats zu ändern. Dieser Parameter ist jedoch schreibgeschützt.
  • Während des Testzeitraums gilt für Kunden ein Limit von maximal 10 Nutzerlizenzen. Kostenpflichtigen Dienst aus einem kostenlosen Testabo starten, um den Testzeitraum sofort zu beenden, die Abrechnung zu starten und die maximale Anzahl von 10 Arbeitsplätzen zu entfernen.

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Inhaber des Kunden sind oder Ihr Kunde den Resellerzugriff auf seine Admin-Konsole deaktiviert hat.

403:usageLimits.dailyLimitExceeded

Dieser Fehler tritt auf, wenn Sie das Tageskontingent für Aufrufe dieser API erreicht haben. Um dieses Problem zu beheben, implementieren Sie eine Backoff-Verzögerung. Weitere Informationen finden Sie unter Nutzungslimits und ‑kontingente.

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

403:usageLimits.accessNotConfigured

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

404:notFound

Bei Verwendung der customers.get-Methode 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 kann durch verschiedene Probleme verursacht werden.

Wenn dieser Fehler bei der Verwendung der Methode subscriptions.changeRenewalSettings auftritt, rufen Sie diese Methode nur für die folgenden Zahlungsmodelle mit Mindestabnahme auf:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

Wenn dieser Fehler bei Verwendung der subscriptions.insert-Methode auftritt, bedeutet das, dass Sie die ausgewählte Artikelnummer entweder nicht weiterverkaufen können oder nicht an den Kunden im Schwellenmarkt. Um dieses Problem zu beheben, müssen Sie die entsprechenden Nutzungsbedingungen akzeptieren.

429:usageLimits.quotaExceeded

Dieser Fehler tritt auf, wenn Sie das Limit für Abfragen pro Sekunde überschritten haben. Um dieses Problem zu beheben, implementieren Sie eine Backoff-Wiederholungsstrategie oder speichern Sie Ergebnisse im Cache, um weniger API-Aufrufe zu tätigen. Weitere Informationen finden Sie unter Nutzungslimits und ‑kontingente.

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