CMS-API: Videosuche v2

Einleitung

Version 2 der von der CMS API vereinfacht die Syntax und vereinfacht die Verwendung.

Die Auswahl der zu verwendenden Syntax ist eine einfache Frage der Auswahl des entsprechenden URL-Parameters:

• So verwenden Sie die neue v2-Suche:

      .../videos?query={search_string}

• So verwenden Sie die ursprüngliche Suche:

      .../videos?q={search_string}

Grundlagen

Das Grundelement einer Suchzeichenfolge ist ein Suchbegriff, dem ein Feldname vorangestellt werden kann. Wenn der Feldname enthalten ist, wird nur dieses Metadatenfeld durchsucht. Andernfalls werden mehrere Felder (unten aufgeführt) durchsucht.

Zum Beispiel:

Wenn Sie keinen zu suchenden Feldnamen angeben, sucht die Anfrage nach diesem Wert in den folgenden Feldern:

• id
• name
• description
• long_description
• text(kein echtes Metadatenfeld, sondern ein Pseudofeld, mit dem Sie nach name description, und suchen können long_description- z. B. text:bird)
• tags
• reference_id
• custom_fields(durchsucht alle benutzerdefinierten Felder)
• custom_field_name(sucht ein bestimmtes benanntes benutzerdefiniertes Feld)

Die unterstützten Felder für die Suche sind:

In den beiden oben gezeigten Beispielen werden möglicherweise trotzdem Videos zurückgegeben, die in keinem relevanten Feld das Wortbird" " enthalten. Im nächsten Abschnitt wird erläutert, wie Sie Suchergebnisse auf Videos mit den angegebenen Begriffen beschränken.

Ignorierte Wörter

Bestimmte Wörter werden in Suchzeichenfolgen ignoriert, da sie so häufig sind, dass sie wahrscheinlich viele Ergebnisse liefern, die nichts mit dem zu tun haben, wonach Sie tatsächlich suchen. Nachfolgend finden Sie eine Liste von Wörtern, die bei der Suche ignoriert werden:

„a“, „an“, „und“, „sind“, „als“, „bei“, „sein“, „aber“, „von“, „für“, „wenn“, „in“, „in“, „in“, „ist“, „es“, „nein“, „nicht“, „von“, „am“, „oder“, „solche“, „dass“, „der“, „ihr“, „dann“, „dort“, „diese“, „sie“, „dies“, „zu“, „war“, „werden“, „mit“

Darüber hinaus werden nicht-alphanumerische Zeichen wie Bindestriche, Unterstriche, Zeilenumbrüche, "$", "&", "*" usw. als Worttrennzeichen behandelt. Beispielsweise wird eine Suchzeichenfolge wie small-town wird behandelt als small town.

Was ist Stemming?

Videofelder, die das Stemmen unterstützen, geben Wörter zurück, die den Stamm des Suchwortes gemeinsam haben. Darüber hinaus unterstützt Stemming nur die Eingabe ganzer Wörter, nicht teilweise Wörter:

• Beispiel 1: Bei der Suche nach running werden Ergebnisse zurückgegeben, die Folgendes enthalten: running, run, runs
• Beispiel 2: Bei der Suche nach vid werden keine Ergebnisse zurückgegeben, die Folgendes enthalten video

Die Suche mit Stemming funktioniert in den folgenden Bereichen:

• custom_fields
• description
• name
• long_description
• tags
• labels
• variants

Erweiterte Suche

Es gibt einige Modifikatoren, mit denen Sie die Suchergebnisse auf genau die gewünschten Videos beschränken können.

Phrasensuche

Sie können nach einer Phrase (und nicht nach einem einzelnen Wort) suchen, indem Sie sie in Anführungszeichen setzen:

• "blue heron"
• name:"blue heron"

Datum/Uhrzeit

Sie können nach einem Datum-Uhrzeit-Intervall suchen, indem Sie Folgendes verwenden:

[{start} TO {end}]

Um nach einem einzelnen Datum/einer Uhrzeit zu suchen, stellen Sie die start und end auf den gleichen Wert:

[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z]

Datum-Uhrzeit-Werte werden im ISO 8601-Format angegeben:

Unten sind einige Beispiel-Suchzeichenfolgen für Datum/Uhrzeit.

Bekannte Probleme

• Doppelte Ergebnisse: In bestimmten Fällen können einige Elemente in den Suchergebnissen mehr als einmal erscheinen.

  Problemumgehung: Um doppelte Suchergebnisse zu vermeiden, verwenden Sie immer a sort Parameter in Ihren Suchanfragen.