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 pausiert 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:

  • Ungültiger Wert für postalAddress.postalCode.
  • postalAddress.countryCode ist für den Weiterverkauf von Google Workspace nicht zulässig.
  • alternateEmail darf nicht in derselben Domain wie customerDomain liegen.

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

Wenn Sie die Methode subscriptions.changeSeats verwenden, kann einer der folgenden Fehler diesen Fehler verursacht haben:

  • Sie können die Anzahl der Lizenzen für Jahrestarife nicht reduzieren. Erwägen Sie die Verlängerungseinstellungen zu ändern. für das Abo, um die Anzahl der Lizenzen zum Zeitpunkt der Verlängerung automatisch auf die Anzahl der aktiven Nutzer im Konto festzulegen.
  • Die von Ihnen angeforderte Anzahl der Lizenzen ist geringer als die aktuelle Anzahl der Nutzer im Konto. Informieren Sie den Kunden, dass er einen Nutzer entfernen muss, bevor er die Anzahl der Lizenzen reduzieren kann.
  • Sie haben den falschen Parameter für die Anzahl der Lizenzen 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 Parameter licensedNumberOfSeats zu ändern, der schreibgeschützt ist.
  • Während des Testzeitraums gilt für Kunden ein Limit von maximal 10 Lizenzen. Wenn Sie einen kostenpflichtigen Dienst über ein kostenloses Testabo starten, um den Testzeitraum sofort zu beenden, die Abrechnung zu starten und das Limit von 10 Lizenzen aufzuheben.

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 tägliche Kontingent für Aufrufe dieser API erreicht haben. Implementieren Sie eine Backoff-Verzögerung, um das 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 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 das Problem zu beheben. Weitere Informationen finden Sie unter Google Workspace APIs aktivieren.

404:notFound

Bei Verwendung der Methode customers.get 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 Verwendung der Methode subscriptions.changeRenewalSettings auftritt, rufen Sie diese Methode nur für die folgenden Zahlungspläne mit Verpflichtung auf:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Wenn dieser Fehler bei Verwendung der Methode subscriptions.delete auftritt, ist im Google Workspace-Konto kein Administratornutzer vorhanden. 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 Methode subscriptions.insert auftritt, können Sie die ausgewählte Artikelnummer entweder nicht weiterverkaufen oder nicht an den Kunden im Schwellenmarkt. 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 überschritten haben. 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 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 alle Abos unter einem Reseller-Konto abzurufen.