Diese Seite wurde von der Cloud Translation API übersetzt.

Probleme mit der Directory API beheben

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

`400:badRequest`

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

Wenn du die users.get-Methode verwendest, überprüfe, ob der an den userKey-Parameter übergebene Wert entweder die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers ist.

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

customer-Parameter: Verwenden Sie nur den von Google generierten customerId. Verwenden Sie nicht die Domain des tatsächlichen Kunden. Wir empfehlen die Verwendung dieses Parameters, da bei einem Kunden mit sekundären Domains mit dem Parameter domain nur Nutzer mit E-Mail-Adressen in dieser bestimmten Domain zurückgegeben werden.
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 Resellerzugriff auf die Admin SDK API deaktiviert hat. Bitten Sie Ihren Kunden, den Zugriff auf die Admin SDK API wieder zu aktivieren, um das Problem zu beheben. Weitere Informationen finden Sie unter API-Zugriff steuern.

Wenn du die Anzahl der aktuell lizenzierten Nutzer abrufen möchtest und dieser Fehler auftritt, verwende anstelle der users.list-Methode das Feld licensedNumberOfSeats aus der Aboressource.

`403:forbidden`

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

Rufe dazu entweder die customers.get-Methode auf, bevor du Aufrufe ausführst, um die Reseller-Inhaberschaft des Kunden zu bestätigen, oder bitte den Kunden, den Reseller-Zugriff auf seine Admin-Konsole wieder zu aktivieren. Weitere Informationen finden Sie im Hilfeartikel Auf die Admin-Konsole eines Kunden zugreifen.

`403:usageLimits.accessNotConfigured`

Dieser Fehler tritt auf, wenn die API im Google Cloud-Projekt nicht aktiviert ist. Rufen Sie dazu die Google Cloud Console auf und aktivieren Sie die API. 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:

Das aktuelle Google Workspace-Konto, dem Sie sie hinzufügen möchten.
Ein anderes Google-Produkt (kein Google Workspace-Produkt)

So beheben Sie das Problem:

Rufen Sie die Methode users.get auf.

Wenn du eine 200-Antwort erhältst, ist der Nutzer bereits im Google Workspace-Konto des Kunden vorhanden. Sie können diesem Konto keinen Nutzer hinzufügen.

Wenn du eine 403 forbidden-Antwort erhältst, ist die Domain im Parameter „primary_email“ entweder kein Reseller-Kunde oder die primäre E-Mail-Adresse wurde bereits für ein anderes Google-Produkt verwendet. Die Domain des Kunden muss zuerst bestätigt werden, bevor dieser Nutzer hinzugefügt werden kann.
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 bis zum letzten Schritt der Domainbestätigung fort.
2. Fügen Sie bei der Bestätigung der Domain die temporären Nutzer dem Parameter owners[] des Anfragetexts für den webResource.insert-Aufruf hinzu. Wiederholen Sie diesen Aufruf, bis Sie eine 200-Antwort erhalten.
3. Nachdem die Domain bestätigt wurde, können Sie den temporären Nutzernamen mit der Methode users.patch oder users.update umbenennen.
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 den Kunden, sich als temporärer Nutzer anzumelden und seine Domain über die Admin-Konsole zu bestätigen.
3. Nachdem die Domain bestätigt wurde, können Sie oder der Kunde den temporären Nutzernamen umbenennen. Sie können entweder die Methode users.patch oder users.update verwenden.

`412:limitExceeded`

Dieser Fehler tritt auf, wenn der Kunde die maximale Anzahl an Plätzen erreicht hat. Verwende die subscriptions.changeSeats-Methode und je nach Abo die folgenden Schritte, um das Problem zu beheben:

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