Zugriff auf die Google Cloud Search API konfigurieren

Bevor Sie die Google Cloud Search API direkt oder über ein SDK verwenden können, müssen Sie den Zugriff darauf konfigurieren. 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 zuerst ein Google Cloud-Projekt erstellen. Dieses Projekt ist die Grundlage für die Verwendung von Google Cloud-Diensten, die Verwaltung von APIs und die Festlegung 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 im Feld Projektname einen Namen ein.
4. Optional: Klicken Sie auf Bearbeiten, um die Projekt-ID zu ändern. Sie können diese ID nach dem Erstellen nicht mehr ändern.
5. Klicken Sie auf SUCHEN, um einen Speicherort auszuwählen, und dann auf Auswählen.
6. Klicken Sie auf Erstellen. Das Projekt ist in der Regel innerhalb weniger Minuten fertig.

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 Ihr neues Projekt im Drop-down-Menü im Banner der Google Cloud Console 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.

Hinweis: Für verschiedene Cloud Search API-Methoden sind unterschiedliche Kontotypen (Administrator-, Dienst- oder Nutzerkonto) erforderlich. Weitere Informationen finden Sie in der Referenzdokumentation.

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 des 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 das Navigationsmenü > IAM & 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.

Hinweis: Wenn Sie das Cloud Search-Tutorial ausgeführt haben, haben Sie die Unterstützung von Drittanbietern bereits initialisiert und können diesen Schritt überspringen.

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 ein Zugriffstoken mit dem OAuth 2.0 Playground ab:
   1. Klicken Sie auf OAuth 2.0-Konfiguration (Einstellungssymbol) 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 Authorize APIs (APIs autorisieren).
   4. Klicken Sie auf Autorisierungscode für Tokens austauschen.

3. Führen Sie diesen curl-Befehl aus und ersetzen Sie dabei [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
   

   Bei Erfolg enthält der Antworttext ein 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 den Wert true hat.

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 im Hilfeartikel Datenquelle für die Suche hinzufügen.
2. Nachdem Sie die Datenquelle eingerichtet haben, können Sie ein Schema erstellen und registrieren, um zu bestimmen, wie die Daten von Cloud Search dargestellt werden sollen.