Mit dem Tool API Explorer können Sie Testanfragen an Cloud Talent Solution senden. Der Explorer blendet ein Formular mit den Parametern für jede Methode ein. Füllen Sie das Formular aus, führen Sie den API-Aufruf aus und sehen Sie sich die Ergebnisse an. Sie müssen auf der Seite Vorbereitung den Abschnitt „GCP Console einrichten“ abgeschlossen haben, um den API Explorer verwenden zu können.
Klicken Sie auf die folgende Schaltfläche, um den API Explorer aufzurufen:
Sie werden automatisch zur Übersicht der Referenzdokumentation für REST weitergeleitet.
Methode wählen
Wählen Sie die Methode aus, die Sie aufrufen möchten. In dieser Demo erfahren Sie, wie Sie die mit Ihrem Google Cloud Platform-Dienstkonto verknüpften Unternehmen auflisten. Wenn Sie noch keine Unternehmen erstellt haben, gibt die API eine leere Liste zurück. Wenn Sie eine andere Methode ausprobieren möchten, führen Sie die weiter unten beschriebenen Schritte aus und beachten Sie dabei die Referenzdokumentation, um Sie durch die erforderlichen Daten für jeden API-Aufruf zu führen.
Klicken Sie zum Auflisten von Unternehmen auf projects.rents.company.list:
Sie werden zur Seite projects.tenants.companies.list weitergeleitet und API Explorer-Formular für die Methode wird angezeigt:
Parameter ausfüllen
Für die im Formular aufgeführten Felder ist nur parent erforderlich. Es empfiehlt sich, auch einen Wert für pageSize einzugeben, insbesondere wenn Sie bereits eine große Anzahl von Unternehmen erstellt haben.
Füllen Sie die folgenden Felder im Formular aus:
- parent:
projects/{projectId}/tenants/{tenantId} pageSize:
20
Ersetzen Sie {project_id} durch Ihre Projekt-ID, kopieren Sie jedoch alle anderen Felder ohne Änderungen. Sie finden Ihre Projekt-ID, indem Sie in der GCP Console das Drop-down-Menü „Projekt“ öffnen:
API Explorer autorisieren
Prüfen Sie zuerst, ob Sie die IAM-Berechtigungen „Cloud Talent Solution-Projektbearbeiter” für Ihr Projekt aktiviert haben. Rufen Sie dazu in der GCP Console Identität > Dienstkonten auf:
Klicken Sie auf Google OAuth 2.0 und API-Schlüssel:
Methode ausführen
Klicken Sie auf die Schaltfläche Ausführen. Klicke im sich öffnenden Fenster auf Zulassen. Die API gibt dann ein Ergebnis in der API Explorer-Seitenleiste zurück. Wenn Sie eine Fehlermeldung erhalten, prüfen Sie, ob Sie die Informationen wie oben angegeben eingegeben und Ihrem Dienstkonto die richtigen Berechtigungen zugewiesen haben. Nehmen Sie die gewünschten Änderungen am Formular vor und klicken Sie noch einmal auf Ausführen. Wenn Sie eine leere Ergebnismenge erhalten, sind mit dem Dienstkonto keine Unternehmen verknüpft. Sie können diese Anleitung mit demjobs.projects.company.create. um ein Unternehmen zu erstellen,Kurzanleitung zum Erstellen von Jobs und Unternehmen aus.
Probieren Sie die API-Methoden und -Formulare ruhig selbstständig aus.
Tipp: Nachdem Sie die gewünschte Ausgabe erhalten haben, setzen Sie ein Lesezeichen für die URL des API-Explorers. Wenn Sie die Methode noch einmal ausführen möchten, fügen Sie die URL in Ihren Browser ein. Das Formular ist bereits mit Ihren Werten gefüllt. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Ausführen, um die Methode auszuführen.