Support Kontaktieren Sie Support | Systemstatus Systemstatus
Inhalt der Seite

    CMS-API: Video-Suche v2

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

    Einführung

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

    Die Auswahl der zu verwendenden Syntax besteht ganz einfach bei der Auswahl des geeigneten URL-Parameters:

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

    Grundlagen

    Das grundlegende Element 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.

    Beispiel:

    Grundlegende Suche
    Suche string Was wird zurückgegeben
    bird Videos, die das Wortbird„ “ in den unten aufgeführten Feldern enthalten
    name:bird Videos, die das Wortbird„ “ im name(Titel) haben, werden zurückgegeben.

    Wenn Sie keinen Feldnamen für die Suche angeben, sucht die Anfrage in den folgenden Feldern nach diesem Wert:

    • id
    • name
    • description
    • long_description
    • text(kein echtes Metadatenfeld, sondern ein Pseudofeld, mit dem Sie das durchsuchen 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 unterstützten Felder für die Suche sind:

    Unterstützte Suchfelder
    Feld Gesetzliche Werte
    name Zeichenfolgen oder Zeichenfolgen in Anführungszeichen
    Text Zeichenfolgen oder Zeichenfolgen in Anführungszeichen (durchsucht die name , description , und long_description)
    tags Strings oder zitierte Strings (mehrere Tags sollten durch Kommas getrennt sein)
    custom_fields Strings oder zitierte Strings (durchsucht alle benutzerdefinierten Felder - Sie können auch einen bestimmten internen Namen für ein bestimmtes benutzerdefiniertes Feld verwenden)
    reference_id string oder zitierte Zeichenfolge
    state ACTIVE, INACTIVE, PENDING, DELETED(Nur in den letzten 10 Tagen gelöschte Videos werden zurückgegeben)
    updated_at datetime oder Bereich (Details unten)
    created_at datetime oder Bereich (Details unten)
    schedule.starts_at datetime oder Bereich (Details unten)
    schedule.ends_at datetime oder Bereich (Details unten)
    published_at datetime oder Bereich (Details unten)
    complete true oder false

    In beiden oben gezeigten Beispielen werden möglicherweise weiterhin Videos zurückgegeben, die in keinem relevanten Feld das Wortbird" " haben. 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.

    Modifikatoren durchsuchen
    Modifizierer Beschreibung Beispiele
    + Das Voranstellen eines Suchbegriffs mit dem Pluszeichen (+) bedeutet, dass die zurückgegebenen Videos den angegebenen Begriff haben müssen
    • +bird ( gibt nur Videos mit "bird " in den oben aufgeführten Feldern zurück)
    • +tags:bird ( gibt nur Videos mit "bird " im zurück tags)
    - oder NOT Voranstellen eines Suchbegriffs mit dem Minuszeichen (-) oder NOT bedeutet, dass die zurückgegebenen Videos nicht den angegebenen Begriff haben dürfen
    • -birds oder NOT birds (gibt nur Videos zurück, die nicht "bird " in den oben aufgeführten Feldern haben)
    • -name:birds oder NOT name:birds (gibt nur Videos zurück, die nicht "bird " im haben name)
    (term) AND (term)
    oder
    (term) OR (term)
    Die AND Logic- und OR Operatoren ermöglichen es Ihnen, mehrere Suchbegriffe für komplexe Abfragen zu kombinieren
    • (+name:heron) AND (+tags:bird) ( würde Videos zurückgeben, die sowohl "heron " in der als name auch "bird " in der tags)
    • (+name:heron) OR (+tags:bird) ( würde Videos zurückgeben, die 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 sowohl "heron " in der als name auch "bird " in der tags, aber nicht das Etikett "internal„)

    Phrasen-Suche

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

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

    Datum/Zeiten

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

    [{start} TO {end}]

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

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

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

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

    Im Folgenden finden Sie einige Suchzeichenfolgen für Datum/Uhrzeit

    Beispieldaten/Zeitsuchen
    Suche String Beschreibung
    +updated_at:[2019-09-30T00:00:00.000Z TO 2019-10-07T00:00:00.000Z] Videos aktualisiert zwischen dem 30. September 2019 und dem 7.
    +created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] Videos, die am 30. Sep 2019 hinzugefügt wurden
    +created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] Videos, die am 30. Sep 2019 zwischen 14.00 und 16.30 Uhr (UTC) hinzugefügt wurden
    +created_at:[* TO 2019-09-30T00:00:00.000Z] Videos, die vor dem 30. Sep 2019 hinzugefügt wurden

    Seite zuletzt aktualisiert am 29 Sep. 2020