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 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 oder die eindeutige Nutzer-ID des Nutzers ist.

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

  • Parameter customer: Verwenden Sie nur die customerId, die von Google generiert wurde. Verwenden Sie nicht die tatsächliche Domain des Kunden. Wir empfehlen, diesen Parameter zu verwenden, da bei 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 tatsächliche Domain des 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 noch einmal zu aktivieren, um das Problem zu beheben. Weitere Informationen finden Sie unter API-Zugriff steuern.

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

403:forbidden

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

Um dieses Problem zu beheben, rufen Sie entweder die customers.get-Methode auf, bevor Sie Aufrufe zur Bestätigung der Reseller-Inhaberschaft des Kunden vornehmen, oder bitten Sie Ihren 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. 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.

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 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 dem Konto nicht hinzufügen.

    Wenn Sie die Antwort 403 forbidden erhalten, 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. In diesem Fall muss die Domain des Kunden zuerst bestätigt werden, bevor dieser Nutzer erfolgreich hinzugefügt werden kann.

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

    1. Erstellen Sie einen temporären Administratornutzer mit der Methode users.insert 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 in den Parameter owners[] des Anfragetexts für den webResource.insert-Aufruf ein. Führen Sie diesen Aufruf aus, bis Sie eine 200-Antwort erhalten.
    3. Nachdem die Domain bestätigt wurde, benennen Sie den temporären Nutzernamen mit der Methode 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 entweder der Kunde oder Sie den temporären Nutzernamen umbenennen. Sie können entweder die Methode users.patch oder users.update verwenden.

412:limitExceeded

Dieser Fehler tritt auf, wenn Ihr Kunde das maximale Kontingent für Arbeitsplätze erreicht hat. Verwenden Sie zur Behebung dieses Problems die Methode subscriptions.changeSeats und je nach Abo die folgenden Werte:

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