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 ausgesetzt 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 für Kundenobjekte 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 vorhanden und für den Kunden gültig sind, um dieses Problem zu beheben.

Wenn Sie die subscriptions.changeSeats-Methode verwenden, kann einer der folgenden Gründe für diesen Fehler verantwortlich sein:

  • Sie können die Anzahl der Nutzerlizenzen für Jahrestarife nicht reduzieren. Ändern Sie die Verlängerungseinstellungen. dass beim Abo automatisch (bei der Verlängerung) die Anzahl der aktiven Nutzer im Konto festgelegt wird.
  • Die von Ihnen angeforderte Anzahl der Lizenzen ist kleiner als die aktuelle Anzahl der Nutzer im Konto. Teile dem Kunden mit, dass er einen Nutzer entfernen muss, bevor er die Anzahl der Plätze verringern kann.
  • Sie haben den falschen Sitzplatzparameter 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, der nur lesend ist.
  • Während des Testzeitraums ist die maximale Anzahl der Nutzerlizenzen auf 10 gesetzt. Starten Sie einen kostenpflichtigen Dienst aus einem kostenlosen Testzeitraum, um den Testzeitraum sofort zu beenden, die Abrechnung zu starten und die maximale Anzahl von 10 Lizenzen aufzuheben.

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Kunde 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 du viele Abos abrufen möchtest, solltest du die Methode subscriptions.list verwenden, ohne die Parameter customerId oder subscriptionId anzugeben. Pro Aufruf können maximal 100 Abos zurückgegeben werden. Mit dem Parameter pageToken kannst du weiterhin alle Abos in 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 dass die Domain verfügbar ist.

412:conditionNotMet

Dieser Fehler kann durch eine Reihe verschiedener Probleme verursacht werden.

Wenn dieser Fehler bei der Verwendung der subscriptions.changeRenewalSettings-Methode auftritt, prüfen Sie, ob Sie diese Methode nur für die folgenden Abos mit fester Laufzeit aufrufen:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

Wenn dieser Fehler bei der Verwendung der subscriptions.insert-Methode auftritt, können Sie die ausgewählte SKU entweder nicht weiterverkaufen oder nicht an Kunden in aufstrebenden Märkten. Akzeptieren Sie die entsprechenden Nutzungsbedingungen, um dieses Problem zu beheben.

429:usageLimits.quotaExceeded

Dieser Fehler tritt auf, wenn Sie die zulässige Anzahl von Abfragen pro Sekunde überschritten haben. Um dieses Problem zu beheben, implementieren Sie eine Backoff-Wiederholstrategie oder speichern Sie Ergebnisse im Cache, um weniger API-Aufrufe auszuführen. Weitere Informationen finden Sie unter Nutzungslimits und Kontingente.

Wenn du viele Abos abrufen möchtest, solltest du die Methode subscriptions.list verwenden, ohne die Parameter customerId oder subscriptionId anzugeben. Pro Aufruf können maximal 100 Abos zurückgegeben werden. Mit dem Parameter pageToken kannst du weiterhin alle Abos in einem Reseller-Konto abrufen.