Einleitung
Playlists für ein Konto können durchsucht werden, indem ein q Parameter für den obigen Aufruf ähnlich der bereitgestellten Videosuchfunktion. Beachten Sie jedoch, dass eine viel geringere Anzahl von Feldern durchsucht werden kann und dass nur die Eigenschaften der Wiedergabeliste durchsucht werden, nicht die Eigenschaften der in der Playlist enthaltenen Videos.
Alle nicht qualifizierten/Standardbegriffe suchen nach Textübereinstimmungen im Feld name, reference_id oder id einer Playlist, zum Beispiel eine Suche nach ?q=news+2016 würde mit einem der folgenden übereinstimmen, wenn sie vorhanden sind:
- Eine Playlist mit dem Namen
Exciting 2016 News - Eine Playlist mit einer ID von 2016
- Eine Playlist mit a
reference_idvonnews 2016
Wie oben angedeutet, sind mehrere Begriffe OR'ed zusammen, und es werden Strings zurückgegeben, die einen oder mehrere der angegebenen Begriffe enthalten. Die angegebenen Werte sind stämmig, sodass Variationen der Wörter abgeglichen werden. Präfixübereinstimmung ist nicht derzeit unterstützt. Also zum Beispiel eine Suche nach p* gibt keine Ergebnisse zurück, die mit "p" beginnen, noch wird eine Suche nach play* Ergebnisse zurückgeben, die "Wiedergabeliste" enthalten.
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.
Felder
Bestimmte Felder können abgefragt werden, indem Sie die {field:}{value} Syntax wie ?q=news+2016+type:EXPLICIT. Auf diese Weise bereitgestellte Felder müssen genau übereinstimmen. Wie andere Begriffe werden dies sein OR'ed.
Die folgenden Felder werden derzeit unterstützt:
- Art
- Name
- beschreibung
- reference_id
Erforderliche Bedingungen
Sie können Begriffe anfordern, indem Sie ihnen einen URI-codierten voranstellen + Vorzeichen (%2B) - Beispiel: q=name:%2Bnews+%2B2016 (was nur Wiedergabelisten mit Namen zurückgeben würde, die sowohl "Nachrichten" als auch "2016" enthalten).
Ausgeschlossene Bedingungen
Begriffe mit einem URI-codierten Präfix - unterschreiben, um Playlists mit diesem Begriff auszuschließen. Zum Beispiel: q=name:%2Bnews+%2D2016 gibt Videos zurück, deren Namen "Nachrichten" enthalten, aber nicht mit "2016".
Stemming
Stemming bezieht sich auf das Speichern und Suchen nach den Wurzeln von Wörtern. Dies bedeutet, dass die Begriffe "spielen", "spielen", "spielen", "gespielt"... alle als "spielen" gespeichert werden und wenn nach einem dieser Begriffe gesucht wird, wird die Suche entsprechend übersetzt nach "spielen" suchen. Stamm gilt nur für den Wortstamm und nicht für Zeichenfolgen, die das Wort beginnen oder Teil davon sind. Daher eine Suche auf name:play gibt Videos mit Namen zurück, die "play", "played", "playing" und "playable" enthalten, aber keine Videos mit Namen, die "display" oder "playlist" enthalten.
UND/ODER
Sie können Suchbedingungen kombinieren mit AND und OR logische Operatoren. Um Mehrdeutigkeiten zu vermeiden (ist AND ein Operator oder ein Teil der Suchzeichenfolge?), müssen Sie Begriffe, die logischen Operatoren vorangehen, in Klammern setzen:
q=(Really Short Videos) AND type:EXPLICITVerschlüsselt würde diese Suchanfrage wie folgt aussehen:
q=name:%28Really%20Short%20Videos%29%20type:EXPLICITVollständige Beispiele
Suche nach Typ
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=type:ACTIVATED_NEWEST_TO_OLDEST
Suche nach Namen mit Ausschlüssen
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=%2Bname=morningnews+%2Ddecription=weekend