Probleme mit der Directory API beheben

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

400:badRequest

Dieser Fehler tritt auf, wenn ein falscher Parameterwert an die Methode übergeben wird.

Wenn Sie die Methode users.get verwenden, prüfen Sie, ob der Wert, der an den Parameter userKey übergeben wird, entweder die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse des Nutzers oder die eindeutige Nutzer-ID ist.

Wenn Sie die Methode users.list verwenden, überprüfen Sie die folgenden Parameter:

  • customer-Parameter: Verwenden Sie nur den von Google generierten customerId. Verwenden Sie nicht die tatsächliche Domain des Kunden. Wir empfehlen die Verwendung dieses Parameters, denn wenn ein Kunde sekundäre Domains hat, werden bei Verwendung des Parameters domain nur Nutzer mit E-Mail-Adressen in dieser bestimmten Domain zurückgegeben.
  • domain-Parameter: Verwenden Sie nur die Domain des Kunden. Verwenden Sie nicht den
    customerId, der von Google generiert wurde.

403:domainCannotUseApis

Dieser Fehler tritt auf, wenn Ihr Kunde den Reseller-Zugriff auf die Admin SDK API deaktiviert hat. Bitten Sie Ihren Kunden, den Zugriff auf die Admin SDK API wieder zu aktivieren, um dieses Problem zu beheben. Weitere Informationen finden Sie unter Zugriff auf die API steuern.

Wenn du die Anzahl der aktuell lizenzierten Nutzer abrufen möchtest und diese Fehlermeldung erhältst, verwende anstelle der Methode users.list das Feld licensedNumberOfSeats aus der Aboressource.

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.

Um dieses Problem zu beheben, rufen Sie entweder die Methode customers.get auf, bevor Sie die Reseller-Inhaberschaft des Kunden bestätigen, oder bitten Sie Ihren Kunden, den Reseller-Zugriff auf seine Admin-Konsole wieder zu aktivieren. Weitere Informationen finden Sie unter Auf die Admin-Konsole eines Kunden zugreifen.

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.

409:duplicate

Dieser Fehler tritt auf, wenn Sie versuchen, einen neuen Nutzer hinzuzufügen, die primäre E-Mail-Adresse des Kunden aber bereits in einem der folgenden Elemente vorhanden ist:

  • Aktuelles Google Workspace-Konto, dem Sie sie hinzufügen möchten.
  • Anderes Google-Produkt (nicht Google Workspace)

So beheben Sie das Problem:

  1. Rufen Sie die Methode users.get auf.

    Wird die Antwort 200 zurückgegeben, ist der Nutzer bereits im Google Workspace-Konto des Kunden vorhanden. Sie können diesen Nutzer dem Konto nicht hinzufügen.

    Wenn Sie die Antwort 403 forbidden erhalten, ist die Domain im primären E-Mail-Parameter kein Kunde eines Resellers oder die primäre E-Mail-Adresse wurde zuvor für ein anderes Google-Produkt verwendet und die Domain des Kunden muss zuerst bestätigt werden, bevor dieser Nutzer hinzugefügt werden kann.

  2. Wenn Sie die Domain des Kunden bestätigen können, gehen Sie so vor:

    1. Erstellen Sie mit der Methode users.insert einen temporären Administrator und fahren Sie mit der Bereitstellung mit dem letzten Schritt zur Domainbestätigung fort.
    2. Fügen Sie beim Bestätigen der Domain die temporären Nutzer in den Parameter owners[] des Anfragetexts für den Aufruf webResource.insert ein. Rufe diesen Anruf aus, bis du eine 200-Antwort erhältst.
    3. Benennen Sie nach der Bestätigung der Domain den temporären Nutzernamen mithilfe der Methode users.patch oder der Methode users.update um.

  3. Wenn Sie die Domain des Kunden nicht bestätigen können, gehen Sie so vor:

    1. Erstellen Sie mit der Methode users.insert einen temporären Administrator.
    2. Bitten Sie Ihren Kunden, sich als temporärer Nutzer anzumelden und seine Domain über die Admin-Konsole zu bestätigen.
    3. Nach der Bestätigung der Domain kann entweder der Kunde oder Sie den temporären Nutzernamen umbenennen. Sie können entweder die Methode users.patch oder die Methode users.update verwenden.

412:limitExceeded

Dieser Fehler tritt auf, wenn ein Kunde die maximal zulässige Anzahl von Nutzerlizenzen erreicht hat. Verwenden Sie zum Beheben dieses Problems die Methode subscriptions.changeSeats und je nach Abomodell Folgendes:

  • Erhöhen Sie für FLEXIBLE den Parameter maximumNumberOfSeats.
  • Erhöhen Sie für ANNUAL den Parameter numberOfSeats.