Zu Handbuch PHP-API

Golem_Api_Video_Latest – Liste der neusten Videos holen

Mit der Klasse Golem_Api_Video_Latest laden Sie eine Liste der neusten Golem.de-Videos.

Einbindung

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

Verwendung

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

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

Im Beispiel nehmen wir an, Sie wollen die 5 neusten 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_Latest::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_Latest::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/Latest.php';

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

$request = new Golem_Api_Video_Latest($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>Latest 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