Auf dieser Seite erfahren Sie, wie Sie eine Vorschau der Suchergebnisse für Media-Apps in derGoogle Cloud Console aufrufen und wie Sie Suchergebnisse über die API abrufen.
Um die Suchanwendung zu implementieren, können Sie ein Such-Widget erstellen und Ihrer Webseite hinzufügen oder API-Aufrufe ausführen und sie in Ihre Webseite oder Anwendung einbinden.
Suchmodi
Es gibt verschiedene Arten von Suchanfragen für Media-Apps:
Vollständige Suchanfragen: Wenn Endnutzer möchten, dass ihr gesamter Suchbegriff oder ihre gesamte Wortgruppe gesucht wird. In einer Musik-Streaming-App geben Nutzer beispielsweise den vollständigen Titel des Songs ein und suchen dann danach. Das ist die bevorzugte Art der Suche, wenn eine Eingabeschnittstelle verwendet wird, die es Nutzern ermöglicht, in einem Schritt zu suchen, z. B. Audio- oder Tastatureingabe.
Bei vollständigen Anfragen erwarten Nutzer, dass Rechtschreibfehler korrigiert werden.
Das Verhalten ist dasselbe wie bei der Suche nach Nicht-Media-Apps (benutzerdefiniert). Weitere Informationen finden Sie unter Suchergebnisse für eine App mit strukturierten oder unstrukturierten Daten abrufen.
Teilweise Suchanfragen (oder Suchanfragen während der Eingabe): Wenn Endnutzer dynamisch eine neue Gruppe von Suchergebnissen erhalten, während sie jeden Buchstaben eingeben. In einer Musikstreaming-App geben Nutzer beispielsweise den Namen des gesuchten Songs ein. Mit jedem Buchstaben, den sie eingeben, werden die Suchergebnisse dynamisch aktualisiert und eingegrenzt.
Automatikmodus: Der Automatikmodus ist eine Mischung aus dem vollständigen und dem teilweisen Modus. Im automatischen Modus wird bei der Mediensuche entschieden, ob die Abfrageergebnisse als Teil- oder Vollversion zurückgegeben werden.
Um die wahrscheinliche Absicht der Endnutzer zu ermitteln, werden bei der Mediensuche verschiedene Signale analysiert und gewichtet, z. B. die Anzahl der eingegebenen Buchstaben, die Eingabegeschwindigkeit und ob es sich bei der Eingabe um eine erkannte Einheit handelt, z. B. den Namen eines Schauspielers oder Films.
Welchen Modus soll ich verwenden?
Der Standardmodus für die Suche nach Medien ist der automatische Modus. Es gibt jedoch Szenarien, in denen Sie den Standardmodus überschreiben und den vollständigen oder teilweisen Abfragemodus angeben möchten. Hier einige Anwendungsbeispiele:
| Szenario | Modus |
|---|---|
| Sie sind sehr zuversichtlich, dass die Anfragen Ihrer Endnutzer vollständig sind. Sie haben beispielsweise ein Suchfeld mit einer Eingabetaste, mit der die Anfrage als abgeschlossen markiert wird, und der Nutzer drückt die Eingabetaste. | Vollständige Anfragen |
| Sie sind sich sehr sicher, dass die Anfragen Ihrer Endnutzer als Teilanfragen gedacht sind. Das heißt, sie erwarten, dass die Ergebnisliste nach jedem eingegebenen Buchstaben aktualisiert wird. | Teilabfragen |
| Keines der oben genannten Szenarien trifft zu. Die Media-Suche entscheidet, ob Abfrageergebnisse als Teil- oder Vollversion zurückgegeben werden. | Automatisch |
Suchergebnisse für eine Media-App abrufen
Sie können sich eine Vorschau der Suchergebnisse in der Google Cloud Konsole ansehen oder Suchergebnisse über die API abrufen. So erhalten Sie Suchergebnisse für eine Media-App:
Console
So verwenden Sie die Google Cloud Konsole, um die Mediensuche als Vorschau anzusehen und ein Widget zu konfigurieren:
Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.
Klicken Sie auf den Namen der App für die Mediensuche.
Klicken Sie auf Configurations (Konfigurationen).
Klicken Sie auf den Tab Benutzeroberfläche.
Legen Sie auf dem Tab UI die Optionen für Allgemeine Konfigurationen und Datendarstellung fest.
Geben Sie im Bereich Vorschau eine Abfrage ein.
Wenn Sie die Konfigurationen speichern und auf dem Tab Integration verfügbar machen möchten, klicken Sie auf Speichern und veröffentlichen.
REST
Verwenden Sie die Methode engines.servingConfigs.search, um Suchergebnisse für eine Media-App abzurufen:
Suchen Sie Ihre App-ID. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.
Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.
Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.
Führen Sie den folgenden curl-Befehl aus, um Ergebnisse für die automatische Vervollständigung zu erhalten.
Alle Felder mit Ausnahme von
contentSearchSpeckönnen in Verbindung mit dem FeldsearchAsYouTypeSpecverwendet werden. Aus Gründen der Übersichtlichkeit wurden die optionalen Felder aus dem curl-Befehl entfernt. Informationen zu den optionalen Feldern finden Sie unter Suchergebnisse für eine App mit strukturierten oder unstrukturierten Daten abrufen.curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \ -d '{ "query": "QUERY", "searchAsYouTypeSpec": {"condition": "SPEC_CONDITION"} }'Ersetzen Sie Folgendes:
PROJECT_ID: die ID Ihres Google Cloud Projekts.PROJECT_ID: die ID Ihres Google Cloud Projekts.APP_ID: Die ID der Vertex AI Search-App, die Sie abfragen möchten.QUERY: Der Abfragetext für die Suche.SPEC_CONDITION: Die Spezifikation für die Suche während der Eingabe kann einen der folgenden Werte haben:ENABLED: für TeilabfragenDISABLED: für vollständige AnfragenAUTO: für eine teilweise oder vollständige Erstattung, je nach Bedarf. Wenn Sie das FeldSPEC_CONDITIONleer lassen oder nicht angeben, ist der StandardsuchmodusAUTO.
Beispielbefehl und Teilergebnis
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/default_search:search" \ -d '{ "query": "Mission Impossible", "searchAsYouTypeSpec": {"condition": "DISABLED"} }'
{ "results": [ { "id": "189333", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/189333", "id": "189333", "structData": { "uri": "http://mytestdomain.movie/content/189333", "title": "Mission: Impossible - Fallout (2018)", "categories": [ "Action", "Adventure", "Thriller" ], "available_time": "2023-01-01T00:00:00Z", "media_type": "movie", "expire_time": "2033-01-01T00:00:00Z" } } }, { "id": "111781", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/111781", "id": "111781", "structData": { "media_type": "movie", "available_time": "2023-01-01T00:00:00Z", "uri": "http://mytestdomain.movie/content/111781", "title": "Mission: Impossible - Rogue Nation (2015)", "categories": [ "Action", "Adventure", "Thriller" ], "expire_time": "2033-01-01T00:00:00Z" } } }, ... { "id": "116507", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/116507", "id": "116507", "structData": { "uri": "http://mytestdomain.movie/content/116507", "categories": [ "Comedy" ], "media_type": "movie", "available_time": "2023-01-01T00:00:00Z", "title": "Mission London (2010)", "expire_time": "2033-01-01T00:00:00Z" } } } ], "totalSize": 5628, "attributionToken": "vgL0PQEKDAiZxMbCBhD2koiqAxIkNjg1MWM3OTUtMDAwMC0yOWVmLThhNzUtZDQzYTJjYzdiYmNmIgVNRURJQSpUtreMLa_WoTGs1qExwvCeFaOAlyKrtZwxxcvzF-7r6TGotZwxkPeyMI6RyTDPv-Iw1L_iMJvWty2Ovp0V1LKdFfHr6THs4K8tkvGsMJXxrDCY1rctMAFKEjB4OTYzYjdjNGE0ZGYwN2FhZlKUAXByb2plY3RzLzc1NjIwNjYwODQ3OS9sb2NhdGlvbnMvZ2xvYmFsL2NvbGxlY3Rpb25zL2RlZmF1bHRfY29sbGVjdGlvbi9lbmdpbmVzL3F1aWNrc3RhcnQtbWVkaWEtcmVjb21tZW5kXzE3NDUwMjUyMjYwNDMvc2VydmluZ0NvbmZpZ3MvZGVmYXVsdF9zZWFyY2g", "nextPageToken": "Y2YiJ2NjNmMhNDNk1SN3EGOtYWZ5ITLwADMw0CN5czYxUDO2QiGDI9kgzIEGIs1tmJCMIBM1IgC", "summary": {}, "queryExpansionInfo": {} }