Zugriff auf die Google Cloud Search API konfigurieren

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

1. API-Projekt erstellen

Sie müssen zuerst ein Google Cloud-Projekt erstellen, um die API zu aktivieren. Dieses Projekt bildet die Grundlage zum Erstellen, Aktivieren und Verwenden aller Google Cloud-Dienste. Dazu gehören 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 in das 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 daher eine ID aus, die Ihren Anforderungen für die gesamte Lebensdauer des Projekts entspricht.

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

  7. Klicken Sie auf einen Speicherort für das Projekt und dann auf Auswählen.

  8. Klicken Sie auf Erstellen. Die Konsole navigiert zur Dashboard-Seite. 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 zu erhalten.

  1. Prüfen Sie, ob Sie wirklich das neu erstellte Projekt verwenden. 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 finden Sie unter APIs in der Google Cloud Console verwalten.

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 Dienstkonto-ID.
  5. Klicken Sie auf Erstellen. Der Bildschirm „Dienstkontoberechtigungen“ wird angezeigt.
  6. Klicken Sie auf Weiter. Der Bildschirm „Nutzern Zugriff auf dieses Dienstkonto gewähren“ wird angezeigt.
  7. Klicken Sie auf SCHLÜSSEL ERSTELLEN und dann auf Fertig. Das Dialogfeld „Privater Schlüssel auf Ihrem Computer gespeichert“ wird angezeigt und eine Kopie des privaten Schlüssels wird auf Ihren Computer heruntergeladen.
  8. Klicken Sie auf Schließen.

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

4. E-Mail-Adresse identifizieren

  1. Wählen Sie in der Google Cloud Console das Projekt aus, das Sie oben auf der Seite erstellt haben.
  2. Klicken Sie links neben dem Banner der Google Cloud Console auf das Navigationsmenü.
  3. Klicken Sie auf IAM und Verwaltung > Dienstkonten.
  4. Notieren Sie sich in der Liste unter "Dienstkonto-ID" die generierte E-Mail-Adresse, mit der das von Ihnen konfigurierte Dienstkonto identifiziert wird. Diese E-Mail-Adresse wird beim Hinzufügen einer Datenquelle zu Cloud Search verwendet.

5. Support von Drittanbietern initialisieren

Bevor Sie andere Cloud Search APIs aufrufen können, müssen Sie den Drittanbietersupport für Google Cloud Search initialisieren.

So initialisieren Sie die Unterstützung durch Drittanbieter für Cloud Search:

  1. Ihr Cloud Search Platform-Projekt enthält Dienstkonto-Anmeldedaten. Damit Sie den Support 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.

  2. Verwenden Sie den OAuth 2 Playground für Google, um ein Zugriffstoken abzurufen:

    1. Klicken Sie auf „Einstellungen“ und klicken Sie das Kästchen Eigene Authentifizierungsdaten verwenden an.
    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 „Bereiche“ 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.
  3. Initialisieren Sie die Unterstützung von Drittanbietern für Cloud Search mit dem folgenden curl-Befehl. Ersetzen Sie [YOUR_ACCESS_TOKEN] durch das in Schritt 2 erhaltene Token.

    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"
    }
    

    Falls das nicht funktioniert, 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 des Drittanbieters 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

Mögliche weitere Schritte:

  1. Wenn Sie Google Cloud Search mit einem nicht von Google stammenden Daten-Repository verwenden möchten, z. B. mit Microsoft® SharePoint®, müssen Sie eine Datenquelle erstellen. Eine Anleitung dazu finden 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 festzulegen, wie die Daten im Repository von Google Cloud Search dargestellt werden sollen.