Sie müssen den Zugriff auf die Google Cloud Search API konfigurieren, bevor Sie können Sie diese API entweder direkt oder über ein SDK verwenden. Dieses Dokument behandelt die erforderlichen Schritte zur Verwendung der Google Cloud Search API REST API
1. API-Projekt erstellen
Zum Aktivieren der API müssen Sie zuerst ein Google Cloud-Projekt erstellen. Dieses bildet die Grundlage für die Erstellung, Aktivierung und Nutzung aller einschließlich Verwaltung von APIs, Aktivieren der Abrechnung, Hinzufügen und Entfernen von Mitbearbeitern und Verwalten von Berechtigungen
Öffnen Sie die Google Cloud Console.
Klicken Sie oben auf der Seite auf
rechts neben „Google Cloud Console“. Ein Dialogfeld mit einer Liste der aktuellen Projekte angezeigt wird.Klicken Sie auf NEUES PROJEKT. Das „Neues Projekt“ erscheint.
Geben Sie einen Projektnamen in das Feld Projektname ein.
Optional: Klicken Sie auf Bearbeiten, um die Projekt-ID zu bearbeiten. Die Projekt-ID darf nicht Änderungen nach der Projekterstellung. Wählen Sie daher ID, die Ihren Anforderungen während der gesamten 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 abrufen.
- Um sicherzustellen, dass Sie sich bei dem neu erstellten Projekt befinden, klicken Sie auf das -Symbol rechts neben dem Google Cloud Console-Banner und wählen Sie Ihr neu erstelltes Projekt aus.
- Klicken Sie auf APIS UND DIENSTE AKTIVIEREN. „Willkommen bei der API-Bibliothek“ Seite angezeigt wird.
- Rufen Sie die Google Cloud Search API auf.
- Klicken Sie auf Aktivieren. Die „Übersicht“ 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
- Führen Sie in der Google Cloud Console folgende Schritte aus: Klicken Sie im linken Navigationsbereich auf Anmeldedaten. Die Seite „Anmeldedaten“ wird angezeigt.
- Wählen Sie in der Drop-down-Liste Anmeldedaten erstellen die Option Dienstkonto. Die „Dienstkonto erstellen“ angezeigt.
- Geben Sie im Feld Name des Dienstkontos einen Namen ein.
- Optional: Bearbeiten Sie die Dienstkonto-ID.
- Klicken Sie auf Erstellen. „Dienstkontoberechtigungen“ erscheint.
- Klicken Sie auf Weiter. „Nutzern Zugriff auf dieses Dienstkonto gewähren“ Bildschirm angezeigt wird.
- Klicken Sie auf SCHLÜSSEL ERSTELLEN und dann auf Fertig. Einen privaten Schlüssel, der in Ihrem Computer“ wird angezeigt und eine Kopie des privaten Schlüssels wird in Ihren Computer.
- Klicken Sie auf Schließen.
Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten, Webanwendungen und installierte Anwendungen
4. E-Mail-Adresse identifizieren
- Führen Sie in der Google Cloud Console folgende Schritte aus: wählen Sie oben auf der Seite das erstellte Projekt aus.
- Klicken Sie links neben dem Banner der Google Cloud Console auf das Navigationsmenü.
- Klicken Sie auf IAM und Verwaltung. Dienstkonten:
- Wählen Sie in der Liste unter „Dienstkonto-ID“ und notieren Sie sich die generierte E-Mail, Adresse, die das von Ihnen konfigurierte Dienstkonto identifiziert. Diese E-Mail-Adresse wird beim Hinzufügen einer Datenquelle zu Cloud Search verwendet.
5. Unterstützung von Drittanbietern initialisieren
Bevor Sie andere Cloud Search APIs aufrufen können, müssen Sie Unterstützung für Google Cloud Search.
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. Um den Drittanbieter-Support zu initialisieren, müssen Sie jedoch Anmeldedaten für die Anwendung. Anweisungen zum Erstellen einer Webanwendung finden Sie unter Anmeldedaten erstellen Nach Abschluss dieses Schritts sollten Sie eine Client-ID und eine Clientschlüsseldatei haben.
Verwenden Sie OAuth 2.0 von Google , um ein Zugriffstoken zu erhalten:
- Klicken Sie auf „Settings“ (Einstellungen) und aktivieren Sie die Option User your own auth credentials (Eigene Anmeldedaten verwenden).
- Geben Sie die Client-ID und den Clientschlüssel aus Schritt 1 ein.
- Klicken Sie auf Schließen.
- 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. - 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 folgendem curl-Befehl . Ersetzen Sie
[YOUR_ACCESS_TOKEN]
durch das Token aus der 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.
Verwenden Sie operations.get, um zu überprüfen, ob Unterstützung von Drittanbietern wird initialisiert:
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 sie Das Feld
done
wurde auftrue
festgelegt. 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 verwenden möchten, wie Microsoft® SharePoint®, muss eine Datenquelle erstellt werden. Anweisungen zur dem Hinzufügen einer Datenquelle, siehe Fügen Sie eine Datenquelle für die Suche hinzu.
Nachdem Sie die Datenquelle eingerichtet haben, können Sie Schema erstellen und registrieren, wie Google Cloud Search die Daten im Repository darstellen soll.