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. Diese Demo zeigt Ihnen, 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. Um eine andere Methode auszuprobieren, führen Sie die weiter unten beschriebenen umfassenden Schritte aus, während Sie in der Referenzdokumentation die erforderlichen Daten für jeden API-Aufruf durchgehen.
Klicken Sie auf projects.tenants.companies.list, um Unternehmen aufzulisten:
Sie werden zur Seite projects.tenants.companies.list
weitergeleitet und API Explorer-Formular für die Methode wird angezeigt:
Parameter ausfüllen
Von den im Formular aufgeführten Feldern ist nur parent
erforderlich. Wir empfehlen, 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
Sorgen Sie zuerst dafür, dass für Ihr Projekt die IAM-Berechtigungen "Cloud Talent Solution-Projektbearbeiter" aktiviert sind. 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. Klicken Sie im dann angezeigten 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 beschrieben eingegeben und die Dienstkontoberechtigungen korrekt festgelegt haben. Nehmen Sie im Formular Änderungen vor und klicken Sie noch einmal auf Ausführen. Wenn Sie eine leere Ergebnismenge erhalten, sind Ihrem Dienstkonto keine Unternehmen zugeordnet. Sie können diese Anleitung mit der Methode jobs.projects.companies.create wiederholen, um ein Unternehmen zu erstellen, oder die Kurzanleitung: Jobs und Unternehmen erstellen. }.
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.