Seitensuchergebnisse

In diesem Thema erfahren Sie, wie Sie das Paging für Ergebnisse von CMS API Anfragen implementieren, wenn die Anforderung mehr Elemente enthält, als Sie gleichzeitig zurückgeben können. Auf diese Weise können Sie große Ergebnismengen in kleineren Gruppen verarbeiten, was die Leistung verbessert. Von einer einzelnen Anfrage werden maximal 100 Datensätze an die CMS-API zurückgegeben. Bei großen Resultsets empfehlen wir jedoch, 25 Elemente pro Anfrage abzurufen, um eine bessere Leistung zu erzielen.

Verfahren

Um das Daten-Paging zu handhaben, gehen Sie wie folgt vor:

  • Rufen Sie eine Zählung der Gesamtzahl der Datensätze in der Ergebnismenge ab.
  • Berechnen Sie die Anzahl der Seiten für Ihre Ergebnismenge.
  • Durchlaufen und anrufen CMS API für jede Datenseite.

Holen Sie sich die Rekordzahl

Zunächst müssen Sie die Gesamtzahl der Videos in Ihrem Ergebnissatz kennen. Die Antwort in der Ergebnismenge hängt von Ihren Suchkriterien ab. Verwenden Sie die counts -Ressource, um eine Gesamtanzahl von Datensätzen in Ihrem Resultset zurückzugeben.

Beispiel: Rufen Sie die Gesamtzahl der Videos in Ihrem Konto ab:

    https://cms.api.brightcove.com/v1/accounts/921483702001/counts/videos

Antwort:

    {
        "count" : 74
    }

Sie können die Anzahl auch begrenzen, indem Sie das optionale verwenden q Parameter. Einzelheiten zur Verwendung von Suchkriterien mit diesem Parameter finden Sie im Verwenden der CMS-API: Videos suchen dokumentieren.

Beispiel: Hier erhalten wir die Anzahl der Videos mit einem Tag-Wert von Tierwelt.

    https://cms.api.brightcove.com/v1/accounts/921483702001/counts/videos?q=tags:wildlife

Antwort:

    {
        "count" : 6
    }

Seiten berechnen

Um die Anzahl der Seiten zu berechnen, dividieren Sie die Gesamtzahl der Datensätze in Ihrem Ergebnissatz durch die Anzahl der Datensätze pro Seite (Seitengröße).

Sie können eine feste Seitengröße festlegen, oder wenn Sie Videodaten auf einer Webseite anzeigen, können Sie den Benutzer die Seitengröße dynamisch einstellen lassen (dh die Anzahl der Videodatenobjekte pro Seite).

JavaScript-Beispiel:

    var numberOfPages = Math.ceil(jsonData.count / pageSize);

Seiten abrufen

Durchlaufen Sie die Anzahl der Seiten, die Sie im vorherigen Schritt berechnet haben, und rufen Sie die auf CMS API mit dem limit und offset Parameter zum Abrufen aufeinanderfolgender Teilmengen von Daten.

In diesem Beispiel werden 10 Videos zurückgegeben, beginnend mit dem 21. Video in Ihrer Ergebnismenge.

    https://cms.api.brightcove.com/v1/accounts/921483702001/videos?limit=10&offset=20

Sie können auch das optionale einschließen q Parameter. Einzelheiten zur Verwendung von Suchkriterien mit diesem Parameter finden Sie im Verwenden der CMS-API: Videos suchen dokumentieren.

Diese Anfrage gibt 2 Videos zurück, beginnend mit dem fünften Video aus der Ergebnismenge von Videos, die den Tag-Wert Wildtiere haben.

    https://cms.api.brightcove.com/v1/accounts/921483702001/videos?q=tags:wildlife&limit=2&offset=4

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.