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. damit bei der Verlängerung automatisch die Anzahl der Lizenzen auf die Anzahl der aktiven Nutzer im Konto festgelegt wird.
  • Die von Ihnen angeforderte Anzahl von 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 maximales Limit von 10 Nutzerlizenzen. Kostenpflichtigen Dienst über ein kostenloses Testabo starten: Der Testzeitraum wird sofort beendet, die Abrechnung beginnt und die maximale Anzahl von 10 Arbeitsplätzen wird aufgehoben.

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Inhaber des Kunden sind 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 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 verschiedene Ursachen haben.

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

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Wenn dieser Fehler bei Verwendung der subscriptions.delete-Methode auftritt, bedeutet das, dass im Google Workspace-Konto kein Administratornutzer vorhanden ist. Fügen Sie einen temporären Administratornutzer hinzu und versuchen Sie es noch einmal, um das 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 cachen Sie Ergebnisse, um weniger API-Aufrufe auszuführen. 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.