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 generiertencustomerId
. 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 Parametersdomain
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:
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.Wenn Sie die Domain des Kunden bestätigen können, gehen Sie so vor:
- 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. - Fügen Sie beim Bestätigen der Domain die temporären Nutzer in den Parameter
owners[]
des Anfragetexts für den AufrufwebResource.insert
ein. Rufe diesen Anruf aus, bis du eine200
-Antwort erhältst. - Benennen Sie nach der Bestätigung der Domain den temporären Nutzernamen mithilfe der Methode
users.patch
oder der Methodeusers.update
um.
- Erstellen Sie mit der Methode
Wenn Sie die Domain des Kunden nicht bestätigen können, gehen Sie so vor:
- Erstellen Sie mit der Methode
users.insert
einen temporären Administrator. - Bitten Sie Ihren Kunden, sich als temporärer Nutzer anzumelden und seine Domain über die Admin-Konsole zu bestätigen.
- 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 Methodeusers.update
verwenden.
- Erstellen Sie mit der Methode
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 ParametermaximumNumberOfSeats
. - Erhöhen Sie für
ANNUAL
den ParameternumberOfSeats
.