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 an den Parameter userKey übergebene Wert 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 domain Parameter nur Nutzer mit E-Mail-Adressen in dieser bestimmten Domain zurückgegeben werden.
  • Parameter domain: 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 wieder zu aktivieren. Weitere Informationen finden Sie unter API-Zugriff steuern.

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

403:forbidden

Dieser Fehler tritt auf, wenn Sie nicht der Eigentümer des Kunden sind oder Ihr Kunde den Reseller-Zugriff auf seine Admin-Konsole deaktiviert hat.

Um dieses Problem zu beheben, rufen Sie entweder die customers.get Methode auf, bevor Sie Anrufe tätigen, um den Reseller-Eigentümer des Kunden zu bestätigen, 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 das 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:

  • Aktuelles Google Workspace-Konto, dem Sie den 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 dem Konto hinzufügen.

    Wenn Sie eine 403 forbidden Antwort erhalten, ist entweder die Domain im Parameter für die primäre E-Mail-Adresse kein weiterverkaufter 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.

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

    1. Erstellen Sie mit der users.insert Methode einen temporären Administratornutzer 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 Aufruf aus, bis Sie eine 200-Antwort erhalten.
    3. Nachdem die Domain bestätigt wurde, benennen Sie den temporären Nutzernamen mit der Methode entweder der users.patch oder der users.update Methoden um.

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

    1. Erstellen Sie mit der users.insert Methode einen temporären Administratornutzer.
    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 die users.patch oder die users.update Methoden verwenden.

412:limitExceeded

Dieser Fehler tritt auf, wenn Ihr Kunde das maximale Limit für die Anzahl der Arbeitsplätze erreicht hat. Um das Problem zu beheben, verwenden Sie die subscriptions.changeSeats Methode und je nach Abo verwenden Sie Folgendes:

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