Suchergebnisse für Medien-Apps abrufen

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 Suche nach Medien entschieden, ob 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. Lassen Sie die Media-Suche entscheiden, ob Abfrageergebnisse als Teil- oder Vollantwort zurückgegeben werden sollen. Automatisch

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:

  1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

    KI-Anwendungen

  2. Klicken Sie auf den Namen der App für die Mediensuche.

  3. Klicken Sie auf Configurations (Konfigurationen).

  4. Klicken Sie auf den Tab Benutzeroberfläche.

  5. Legen Sie auf dem Tab UI die Optionen für Allgemeine Konfigurationen und Datendarstellung fest.

  6. Geben Sie im Bereich Vorschau eine Abfrage ein.

  7. 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:

  1. Suchen Sie Ihre App-ID. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Führen Sie den folgenden curl-Befehl aus, um Ergebnisse für die automatische Vervollständigung zu erhalten.

    Alle Felder mit Ausnahme von contentSearchSpec können in Verbindung mit dem Feld searchAsYouTypeSpec verwendet 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 Teilabfragen
      • DISABLED: für vollständige Anfragen
      • AUTO: für eine teilweise oder vollständige Erstattung, je nach Bedarf. Wenn Sie das Feld SPEC_CONDITION leer lassen oder nicht angeben, ist der Standardsuchmodus AUTO.

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

Nächste Schritte