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.

Prüfen Sie bei Verwendung der Methode users.get, ob der Wert in den Parameter userKey entweder die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers ist.

Prüfen Sie bei Verwendung der Methode users.list die folgenden Parameter:

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

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 API-Zugriff steuern.

Wenn Sie die Anzahl der aktuell lizenzierten Nutzer abrufen möchten und dieser Fehler angezeigt wird, verwenden Sie anstelle der Methode users.list das Feld licensedNumberOfSeats aus der Aboressource.

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Kunde sind oder der Kunde den Reseller-Zugriff auf seine Admin-Konsole deaktiviert hat.

Rufen Sie zum Beheben dieses Problems die Methode customers.get auf, bevor Sie Aufrufe aufrufen, um die Inhaberschaft des Resellers durch den Kunden zu bestätigen, oder bitten Sie Ihren Kunden, den Reseller-Zugriff auf seine Admin-Konsole wieder zu aktivieren. Weitere Informationen finden Sie unter Admin-Konsole eines Kunden aufrufen.

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 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 jedoch bereits in einem der folgenden Konten vorhanden ist:

  • Das aktuelle Google Workspace-Konto, dem Sie die Nutzer hinzufügen möchten.
  • Ein anderes Google-Produkt (nicht Google Workspace).

So beheben Sie das Problem:

  1. Rufen Sie die Methode users.get auf.

    Wenn Sie eine 200-Antwort erhalten, ist der Nutzer bereits im Google Workspace-Konto des Kunden vorhanden. Sie können diesen Nutzer nicht zum Konto hinzufügen.

    Wenn Sie eine 403 forbidden-Antwort erhalten, ist entweder die Domain im primären E-Mail-Parameter kein Reseller-Kunde 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 mithilfe der Methode users.insert einen temporären Administrator und fahren Sie mit der Bereitstellung bis zum letzten Schritt der Domainbestätigung fort.
    2. Fügen Sie beim Bestätigen der Domain die temporären Nutzer dem owners[]-Parameter des Anfragetexts für den webResource.insert-Aufruf hinzu. Führen Sie diesen Anruf aus, bis Sie eine 200-Antwort erhalten.
    3. Nachdem die Domain bestätigt wurde, benennen Sie den temporären Nutzernamen mit den Methoden users.patch oder 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. Nachdem die Domain bestätigt wurde, kann der Kunde oder Sie den temporären Nutzernamen umbenennen. Sie können die Methode users.patch oder users.update verwenden.

412:limitExceeded

Dieser Fehler tritt auf, wenn Ihr Kunde die maximal zulässige Anzahl an Nutzerlizenzen erreicht hat. Verwenden Sie die Methode subscriptions.changeSeats und verwenden Sie je nach Abo Folgendes:

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