Zu Handbuch PHP-API

Golem_Api_Video_Top – Liste der beliebtesten Videos holen

Mit der Klasse Golem_Api_Video_Top laden Sie die Liste der zur Zeit meistaufgerufenen Golem.de-Videos.

Einbindung

require_once '[Installationsort/]Golem/Request.php';
require_once '[Installationsort/]Golem/Api/Video/Top.php';

Verwendung

Um ein neues Objekt der Klasse Golem_Api_Video_Top zu erzeugen, übergeben Sie dem Konstruktor Ihren Entwicklerschlüssel und bestimmen, wie lang die Liste werden soll:

$request = new Golem_Api_Video_Top($developerKey, 5);
Beispiel 1: Objektinitialisierung

Im Beispiel nehmen wir an, Sie wollen die 5 beliebtesten Videos abfragen.

Die eigentliche Abfrage erfolgt mit der Methode fetch(). War sie erfolgreich, erhalten Sie mit der getVideos()-Methode die Liste der Artikel als Array. Jeder Eintrag des Arrays enthält die Daten eines Videos in Form eines assoziation Arrays.

$request->fetch();

$videos = $request->getVideos();
Beispiel 2: Abfrage starten und Daten holen

Fehlerbehandlung

Während der Datenabfrage können Fehler auftreten:

  • Golem_Api_Video_Top::ERROR_LIMIT bedeutet, dass die angeforderte Listenlänge der meistgesehenen Videos entweder zu klein ist (kleiner als 1) oder zu groß. Derzeit beträgt der größtmögliche Wert 50.

Wenn während der Abfrage ein Fehler auftritt, wird eine Exception geworfen, die Sie mit try-catch auffangen können.

try {

 $request->fetch();

 $videos = $request->getVideos();

} catch(Exception $e) {

 switch($e->getErrorCode()) {

  case Golem_Api_Video_Top::ERROR_LIMIT :
       ...
       break;
  case ...

 }

}
Beispiel 3: Fehler abfangen

Verfügbare Videodaten

Für jedes Video werden folgende Eigenschaften mitgeliefert:

Name Bedeutung
videoid Video-Identifier
title Der Titel des Videos
url Die URL der Videoseite

Vollständiges Beispiel

<?php

require_once 'Golem/Request.php';
require_once 'Golem/Api/Video/Top.php';

$developerKey = '..';
$videos       = array();
$error        = '';

$request = new Golem_Api_Video_Top($developerKey, 5);

try {

 $request->fetch();

 $videos = $request->getVideos();

} catch( Exception $e ) {

 switch($e->getErrorCode()) {

  case Golem_Api_Video_Top::ERROR_LIMIT :
       $error = 'Es wurden zuwenig oder zuviele Videos angefordert!';
       break;

  default :
        $error = 'Es trat ein interner Fehler auf!';

 }

}

?>

<html>
 <head>
  <title>Top video example</title>
 </head>
 <body>
  <?php echo $error; ?>
  <ul>
   <?php

   foreach($videos as $video) {

    echo '<li>';
    echo '<a href="'.$video['url'].'">'.$video['title'].'</a>';
    echo '</li>';

   }

   ?>
  </ul>
 </body>
</html>



Zu Handbuch PHP-API