Diese Seite wurde von der Cloud Translation API übersetzt.

Zugriff auf die Google Cloud Search API konfigurieren

Damit Sie diese API entweder direkt oder über ein SDK verwenden können, müssen Sie den Zugriff auf die Google Cloud Search API konfigurieren. In diesem Dokument werden die Schritte beschrieben, die zur Verwendung der REST API der Google Cloud Search API erforderlich sind.

1. API-Projekt erstellen

Zum Aktivieren der API müssen Sie zuerst ein Google Cloud-Projekt erstellen. Dieses Projekt bildet die Grundlage für das Erstellen, Aktivieren und Verwenden aller Google Cloud-Dienste, einschließlich der Verwaltung von APIs, des Aktivierens der Abrechnung, des Hinzufügens und Entfernens von Mitbearbeitern und des Verwaltens von Berechtigungen.

Öffnen Sie die Google Cloud Console.
Klicken Sie oben auf der Seite rechts neben „Google Cloud Console“ auf . Ein Dialogfeld mit den aktuellen Projekten wird angezeigt.
Klicken Sie auf NEUES PROJEKT. Der Bildschirm „Neues Projekt“ wird angezeigt.
Geben Sie einen Projektnamen in das Feld Projektname ein.
Optional: Klicken Sie auf Bearbeiten, um die Projekt-ID zu bearbeiten. Die Projekt-ID kann nach dem Erstellen des Projekts nicht mehr geändert werden. Wählen Sie daher eine ID aus, die Ihren Anforderungen für die gesamte Lebensdauer des Projekts entspricht.
Klicken Sie auf SUCHEN, um nach Standorten für das Projekt zu suchen.
Klicken Sie auf einen Speicherort für Ihr Projekt und dann auf Auswählen.
Klicken Sie auf Erstellen. Die Konsole navigiert zur Seite „Dashboard“. Das Projekt wird innerhalb weniger Minuten erstellt.

Weitere Informationen zum Erstellen und Verwalten von Projekten finden Sie unter Projekte erstellen und verwalten.

2. API aktivieren

Sie müssen die Google Cloud Search API aktivieren und ein Dienstkonto erstellen, um Anmeldedaten abzurufen.

Prüfen Sie, ob Sie sich im neu erstellten Projekt befinden. Klicken Sie dazu rechts neben dem Banner der Google Cloud Console auf das Symbol und wählen Sie das neu erstellte Projekt aus.
Klicken Sie auf APIS UND DIENSTE AKTIVIEREN. Die Seite „Willkommen bei der API-Bibliothek“ wird angezeigt.
Rufen Sie die Google Cloud Search API auf.
Klicken Sie auf Aktivieren. Die Seite „Übersicht“ wird angezeigt.

Weitere Informationen zum Aktivieren und Deaktivieren von APIs finden Sie unter APIs in der Google Cloud Console verwalten.

3. Anmeldedaten für ein Dienstkonto erstellen

Klicken Sie in der Google Cloud Console im linken Navigationsbereich auf Anmeldedaten. Die Seite „Anmeldedaten“ wird angezeigt.
Wählen Sie in der Drop-down-Liste Anmeldedaten erstellen die Option Dienstkonto aus. Die Seite „Dienstkonto erstellen“ wird angezeigt.
Geben Sie im Feld Name des Dienstkontos einen Namen ein.
Optional: Bearbeiten Sie die Dienstkonto-ID.
Klicken Sie auf Erstellen. Der Bildschirm „Dienstkontoberechtigungen“ wird angezeigt.
Klicken Sie auf Weiter. Der Bildschirm „Nutzern Zugriff auf dieses Dienstkonto erteilen“ wird angezeigt.
Klicken Sie auf SCHLÜSSEL ERSTELLEN und dann auf Fertig. Das Dialogfeld „Privater Schlüssel wurde auf Ihrem Computer gespeichert“ wird angezeigt und eine Kopie des privaten Schlüssels wird auf Ihren Computer heruntergeladen.
Klicken Sie auf Schließen.

Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten, Webanwendungen und installierte Anwendungen.

4. E-Mail-Adresse identifizieren

Wählen Sie in der Google Cloud Console das Projekt aus, das Sie oben auf der Seite erstellt haben.
Klicken Sie links neben dem Banner der Google Cloud Console auf das Navigationsmenü.
Klicken Sie auf IAM und Verwaltung > Dienstkonten.
Notieren Sie sich in der Liste unter „Dienstkonto-ID“ die generierte E-Mail-Adresse, die das von Ihnen konfigurierte Dienstkonto identifiziert. Diese E-Mail-Adresse wird verwendet, wenn Cloud Search eine Datenquelle hinzugefügt wird.

5. Unterstützung von Drittanbietern initialisieren

Bevor Sie andere Cloud Search APIs aufrufen können, müssen Sie die Drittanbieterunterstützung für Google Cloud Search initialisieren.

So initialisieren Sie die Unterstützung von Drittanbietern für Cloud Search:

Ihr Projekt für die Cloud Search-Plattform enthält Anmeldedaten für ein Dienstkonto. Damit Sie die Unterstützung von Drittanbietern initialisieren können, müssen Sie jedoch Anmeldedaten für die Webanwendung erstellen. Eine Anleitung zum Erstellen von Anmeldedaten für Webanwendungen finden Sie unter Anmeldedaten erstellen. Nach Abschluss dieses Schritts sollten Sie eine Client-ID und eine Clientschlüsseldatei haben.
Verwenden Sie den OAuth 2-Playground von Google, um ein Zugriffstoken abzurufen:
1. Klicken Sie auf „Settings“ (Einstellungen) und aktivieren Sie die Option User your own auth credentials (Eigene Anmeldedaten verwenden).
2. Geben Sie die Client-ID und den Clientschlüssel aus Schritt 1 ein.
3. Klicken Sie auf Schließen.
4. Geben Sie im Feld mit den Bereichen https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf Autorisieren. Der OAuth 2 Playground gibt einen Autorisierungscode zurück.
5. Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.

Initialisieren Sie die Unterstützung von Drittanbietern für Cloud Search mit dem folgenden curl-Befehl. Ersetzen Sie [YOUR_ACCESS_TOKEN] durch das Token aus Schritt 2.

curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von operation. Beispiel:

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

Wenn das Problem weiterhin besteht, wenden Sie sich an den Cloud Search-Support.

Mit operations.get können Sie prüfen, ob die Unterstützung von Drittanbietern initialisiert wurde:

curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

Wenn die Initialisierung des Drittanbieters abgeschlossen ist, enthält es das Feld done, das auf true gesetzt ist. Beispiel:

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

Nächste Schritte

Als Nächstes können Sie Folgendes tun:

Wenn Sie Google Cloud Search mit einem Daten-Repository von Drittanbietern wie Microsoft® SharePoint® verwenden möchten, müssen Sie eine Datenquelle erstellen. Eine Anleitung zum Hinzufügen einer Datenquelle finden Sie im Hilfeartikel Datenquelle für die Suche hinzufügen.
Nachdem Sie die Datenquelle eingerichtet haben, können Sie ein Schema erstellen und registrieren, um zu bestimmen, wie Google Cloud Search die Daten im Repository darstellen soll.