Zugriff auf die Google Cloud Search API konfigurieren

Sie müssen den Zugriff auf die Google Cloud Search API konfigurieren, bevor Sie sie direkt oder über ein SDK verwenden. In diesem Dokument werden die erforderlichen Schritte für die Cloud Search API REST API beschrieben.

1. API-Projekt erstellen

Bevor Sie die API aktivieren können, müssen Sie ein Google Cloud-Projekt erstellen. Dieses Projekt ist die Grundlage für die Verwendung von Google Cloud-Diensten, die Verwaltung von APIs und das Festlegen von Berechtigungen.

  1. Öffnen Sie die Google Cloud Console.
  2. Klicken Sie rechts neben „Google Cloud Console“ auf das Drop-down-Menü für Projekte und wählen Sie NEUES PROJEKT aus.
  3. Geben Sie einen Namen in das Feld Projektname ein.
  4. Optional: Klicken Sie auf Bearbeiten , um die Projekt-ID zu ändern. Diese ID kann nach der Erstellung nicht mehr geändert werden.
  5. Klicken Sie auf SUCHEN , um einen Standort auszuwählen, und dann auf Auswählen.
  6. Klicken Sie auf Erstellen. Das Projekt ist in der Regel innerhalb weniger Minuten einsatzbereit.

Weitere Informationen finden Sie unter Projekte erstellen und verwalten.

2. API aktivieren

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

  1. Wählen Sie im Banner der Google Cloud Console Ihr neues Projekt aus dem Drop-down-Menü aus.
  2. Klicken Sie auf APIS UND DIENSTE AKTIVIEREN.
  3. Suchen Sie nach der Google Cloud Search API und wählen Sie sie aus.
  4. Klicken Sie auf Aktivieren.

Weitere Informationen 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.
  2. Wählen Sie im Drop-down-Menü Anmeldedaten erstellen die Option Dienstkonto aus.
  3. Geben Sie im Feld Name des Dienstkontos einen Namen ein.
  4. Optional: Bearbeiten Sie die ID des Dienstkontos.
  5. Klicken Sie auf Erstellen und fortfahren.
  6. Klicken Sie auf Fertig , um zur Liste „Dienstkonten“ zu gelangen.
  7. Klicken Sie auf die E‑Mail-Adresse Ihres neuen Dienstkontos und wählen Sie den Tab Schlüssel aus.
  8. Klicken Sie auf SCHLÜSSEL HINZUFÜGEN > Neuen Schlüssel erstellen.
  9. Wählen Sie JSON aus und klicken Sie auf Erstellen. Der private Schlüssel wird auf Ihren Computer heruntergeladen.

Weitere Informationen finden Sie unter Dienstkonten.

4. E‑Mail-Adresse des Dienstkontos ermitteln

  1. Wählen Sie in der Google Cloud Console Ihr Projekt aus.
  2. Klicken Sie auf Navigationsmenü > IAM und Verwaltung > Dienstkonten.
  3. Notieren Sie sich die E‑Mail-Adresse für Ihr Dienstkonto. Sie benötigen sie, um Cloud Search eine Datenquelle hinzuzufügen.

5. Unterstützung von Drittanbietern initialisieren

Initialisieren Sie die Unterstützung von Drittanbietern für Google Cloud Search, bevor Sie andere Cloud Search APIs aufrufen.

So initialisieren Sie die Unterstützung von Drittanbietern:

  1. Erstellen Sie Anmeldedaten für Webanwendungen in Ihrem Cloud Search-Plattformprojekt. Weitere Informationen finden Sie unter Anmeldedaten erstellen. Sie benötigen die Client-ID und den Clientschlüssel.
  2. Rufen Sie mit dem OAuth 2.0 Playground ein Zugriffstoken ab:
    1. Klicken Sie auf OAuth 2.0-Konfiguration (Symbol für Einstellungen) und setzen Sie ein Häkchen bei Eigene OAuth-Anmeldedaten verwenden.
    2. Geben Sie Ihre Client-ID und Ihren Clientschlüssel ein.
    3. Geben Sie im Feld „Scopes“ (Bereiche) https://www.googleapis.com/auth/cloud_search.settings ein und klicken Sie auf APIs autorisieren.
    4. Klicken Sie auf Autorisierungscode für Tokens austauschen.

  3. Führen Sie diesen curl-Befehl aus und ersetzen Sie [YOUR_ACCESS_TOKEN] durch Ihr 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 einen operation. Ist der Vorgang nicht erfolgreich, wenden Sie sich an den Cloud Search-Support.

  4. Verwenden Sie operations.get , um die Initialisierung zu prüfen:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    Die Initialisierung ist abgeschlossen, wenn done auf true gesetzt ist.

Nächste Schritte

  1. Wenn Sie Cloud Search mit einem Repository verwenden möchten, das nicht zu Google gehört, z. B. Microsoft® SharePoint®, müssen Sie eine Datenquelle erstellen. Weitere Informationen finden Sie unter Datenquelle für die Suche hinzufügen.
  2. Nachdem Sie die Datenquelle eingerichtet haben, erstellen und registrieren Sie ein Schema. um festzulegen, wie Cloud Search Ihre Daten darstellen soll.