Support Kontakt Support | Systemstatus Systemstatus
Seiteninhalt

    CMS API: Videosuche v2

    In diesem Thema wird die Syntax für die Verwendung von Version 2 der Videosuche erläutert, die von der unterstützt wird CMS API.

    Einführung

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

    Die Wahl der zu verwendenden Syntax ist ganz einfach, indem Sie den entsprechenden URL-Parameter auswählen:

    • So verwenden Sie die neue v2-Suche:
          .../videos?query={search_string}
    • So verwenden Sie die ursprüngliche Suche:
          .../videos?q={search_string}

    Wesentliches

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

    Beispielsweise:

    Einfache Suche
    Suchbegriff Was wird zurückgegeben
    bird Videos, die das Wort "bird"in den unten aufgeführten Feldern
    name:bird Videos mit dem Wort "bird"In der name (Titel) wird zurückgegeben.

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

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

    Die zu durchsuchenden unterstützten Felder sind:

    Unterstützte Suchfelder
    Feld Rechtliche Werte
    name Strings oder zitierte Strings
    Text Zeichenketten oder in Anführungszeichen stehende Zeichenfolgen (sucht im name, description, und long_description)
    tags Zeichenfolgen oder Zeichenfolgen in Anführungszeichen (mehrere Tags sollten durch Kommas getrennt sein)
    custom_fields Zeichenfolgen oder Zeichenfolgen in Anführungszeichen (durchsucht alle benutzerdefinierten Felder - Sie können auch ein bestimmtes benutzerdefiniertes Feld verwenden intern Name)
    reference_id Zeichenfolge oder Zeichenfolge in Anführungszeichen
    state ACTIVE, INACTIVE, PENDING, DELETED (Es werden nur Videos zurückgegeben, die innerhalb der letzten 10 Tage gelöscht wurden.)
    updated_at datetime oder range (Details unten)
    created_at datetime oder range (Details unten)
    schedule.starts_at datetime oder range (Details unten)
    schedule.ends_at datetime oder range (Details unten)
    published_at datetime oder range (Details unten)
    complete true or false

    In beiden oben gezeigten Beispielen sind Videos ohne das Wort "bird"in einem relevanten Feld möglicherweise noch zurückgegeben. Im nächsten Abschnitt wird erläutert, wie Sie die Suchergebnisse auf Videos beschränken, die die angegebenen Begriffe enthalten.

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

    Suchmodifikatoren
    Veränderung Beschreibung Beispiele
    + Das Voranstellen eines Suchbegriffs mit dem Pluszeichen (+) bedeutet, dass die zurückgegebenen Videos sollen habe den angegebenen Begriff
    • +bird (kehrt zurück ausschließlich Videos mit "bird"in den oben aufgeführten Feldern)
    • +tags:bird (kehrt zurück ausschließlich Videos mit "bird"In der tags)
    - or NOT Einem Suchbegriff das Minuszeichen (-) oder voranstellen NOT bedeutet, dass die zurückgegebenen Videos Muss nicht habe den angegebenen Begriff
    • -birds or NOT birds (gibt nur Videos zurück, die dies tun haben "bird"in den oben aufgeführten Feldern)
    • -name:birds or NOT name:birds (gibt nur Videos zurück, die dies tun haben "bird"In der name)
    (term) AND (term)
    or
    (term) OR (term)
    Die logische AND und OR Mit Operatoren können Sie mehrere Suchbegriffe für komplexe Abfragen kombinieren
    • (+name:heron) AND (+tags:bird) (würde Videos zurückgeben, die haben beide "heron"In der name und "bird"In der tags)
    • (+name:heron) OR (+tags:bird) (würde Videos zurückgeben, die haben entweder "heron"In der name und "bird"In der tags)
    • ((+name:heron) AND (+tags:bird)) AND (NOT tags:internal) (würde Videos zurückgeben, die haben beide "heron"In der name und "bird"In der tags, Aber der tag "internal")

    Phrasensuche

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

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

    Datum / Uhrzeit

    Sie können nach einem Datums- / Zeitintervall suchen, indem Sie Folgendes verwenden:

    [{start} TO {end}]

    Um nach einem 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]

    Datums- und Uhrzeitwerte werden im ISO 8601-Format angegeben:

    Datums- / Zeitformate
    Terminzeit Format Beispiel
    Terminzeit yyyy-MM-ddThh:mm:ss.sssZ 2019-09-30T14:24:33.512Z
    Platzhalter (kann für Start- oder Enddatum / -zeit verwendet werden) *
    • 2019-09-30T14:24:33.512Z TO *
    • * TO 2019-09-30T14:24:33.512-4:00Z

    Im Folgenden finden Sie einige Beispiele für Datums- / Uhrzeitsuchzeichenfolgen.

    Beispieldaten / Zeitsuchen
    Suchbegriff Beschreibung
    +updated_at:[2019-09-30T00:00:00.000Z TO 2019-10-07T00:00:00.000Z] Die Videos wurden zwischen dem 30. September 2019 und dem 7. Oktober 2019 aktualisiert
    +created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] Videos hinzugefügt am 30 Sep 2019
    +created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] Videos wurden zwischen 2 Uhr und 00 Uhr (UTC) am 4. September 30 hinzugefügt
    +created_at:[* TO 2019-09-30T00:00:00.000Z] Vor dem 30. September 2019 hinzugefügte Videos

    Seite zuletzt aktualisiert am 29