Zugriff auf die Google Cloud Search API konfigurieren

Bevor Sie die Google Cloud Search API entweder direkt oder über ein SDK verwenden können, müssen Sie den Zugriff darauf konfigurieren. In diesem Dokument finden Sie die dafür notwendigen Schritte.

1. API-Projekt erstellen

Bevor Sie die API aktivieren können, 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. Dazu gehören auch das Verwalten von APIs, das Aktivieren der Abrechnung, das Hinzufügen und Entfernen von Mitbearbeitern sowie das Verwalten von Berechtigungen.

  1. Öffnen Sie die Google Cloud Console.

  2. Klicken Sie oben auf der Seite rechts neben „Google Cloud Console“ auf . Ein Dialogfeld mit den aktuellen Projekten wird angezeigt.

  3. Klicken Sie auf NEUES PROJEKT. Der Bildschirm „Neues Projekt“ wird angezeigt.

  4. Geben Sie im Feld Projektname einen Projektnamen ein.

  5. 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 also eine ID aus, die während der gesamten Dauer des Projekts den Anforderungen entspricht.

  6. Klicken Sie auf SUCHEN, um nach Standorten für das Projekt zu suchen.

  7. Klicken Sie auf einen Standort für Ihr Projekt und dann auf Auswählen.

  8. Klicken Sie auf Erstellen. Sie werden zur Seite „Dashboard“ weitergeleitet. Das Projekt wird innerhalb weniger Minuten erstellt.

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

2. API aktivieren

Aktivieren Sie die Google Cloud Search API und erstellen Sie ein Dienstkonto, um Anmeldedaten zu erhalten.

  1. Sorgen Sie dafür, dass Sie sich auch wirklich im richtigen 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.
  2. Klicken Sie auf APIS UND DIENSTE AKTIVIEREN. Die Seite „Willkommen bei der API-Bibliothek“ wird angezeigt.
  3. Rufen Sie die Google Cloud Search API auf.
  4. Klicken Sie auf Aktivieren. Die Seite „Übersicht“ wird angezeigt.

Weitere Informationen zum Aktivieren und Deaktivieren von APIs.

3. Anmeldedaten für ein Dienstkonto erstellen

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

Weitere Informationen zu Dienstkonten, Webanwendungen und installierten Anwendungen.

4. E-Mail-Adresse angeben

  1. Wählen Sie in der Google Cloud Console oben auf der Seite das erstellte Projekt aus.
  2. Klicken Sie links neben dem Banner der Google Cloud Console auf das Navigationsmenü.
  3. Klicken Sie auf IAM & Verwaltung > Dienstkonten.
  4. In der Liste finden Sie die erstellte E-Mail-Adresse unter „Dienstkonto-ID“. Notieren Sie sie. Mit ihr kann das von Ihnen konfigurierte Dienstkonto identifiziert werden. Außerdem wird sie verwendet, wenn Cloud Search eine Datenquelle hinzugefügt werden soll.

5. Unterstützung von Drittanbietern initialisieren

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

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

  1. Ihr Projekt für die Cloud Search Platform enthält Anmeldedaten für ein Dienstkonto. Für die Initialisierung der Unterstützung von Drittanbietern müssen Sie allerdings Anmeldedaten für die Webanwendung erstellen. Eine entsprechende Anleitung finden Sie unter Anmeldedaten erstellen. Nach Abschluss dieses Schritts sollten Sie eine Client-ID und eine Clientschlüsseldatei haben.

  2. Verwenden Sie den OAuth-2.0-Playground von Google, um ein Zugriffstoken abzurufen:

    1. Klicken Sie auf „Settings“ (Einstellungen) und setzen Sie ein Häkchen bei 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 „Scopes“ (Bereiche) https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf Authorize (Autorisieren). Im OAuth-2-Playground wird ein Autorisierungscode zurückgegeben.
    5. Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.

  3. Initialisieren Sie die Unterstützung von Drittanbietern für Cloud Search mit folgendem 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"
}

    Ist der Vorgang nicht erfolgreich, wenden Sie sich an den Cloud Search-Support.

  4. 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 für Drittanbieter abgeschlossen ist, enthält das Feld done den Wert true. Beispiel:

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

Nächste Schritte

Bei Bedarf können Sie die folgenden Schritte ausführen:

  1. Wenn Sie beabsichtigen, Google Cloud Search mit einem Datenrepository zu verwenden, das nicht zu Google gehört, z. B. mit Microsoft® SharePoint®, müssen Sie eine Datenquelle erstellen. Weitere Informationen dazu erhalten Sie im Hilfeartikel Datenquelle für die Suche hinzufügen.

  2. Sobald Sie die Datenquelle eingerichtet haben, können Sie ein Schema erstellen und registrieren, um zu bestimmen, wie die Repository-Daten von Google Cloud Search dargestellt werden sollen.