La pluparts des services Google Data requièrent l'authentification de l'application cliente auprès du serveur Google avant d'accéder aux données privés, de sauvegarder des données ou d'en supprimer. Il y a deux implémentations de l'authentification sur Google Data : AuthSub et ClientLogin. Zend-Gdata fourni des interfaces (Classes) pour chacunes de ces methodes.

La plupart des autres types de rêquetes au travers du service Google Data ne requièrent pas d'authentification.

Zend_Gdata utilise Zend_Feed et Zend_Http_Client pour envoyer des données à google.com et récupérer les resultats. The response to most La plupart des réponses sont retournés sous la forme d'objets Zend_Feed au format Atom ou fil RSS.

L'utilisation de Zend_Gdata nécesite que l'hote sur lequel votre application PHP tourne ait accès au réseau Internet. Le client Zend_Gdata procède en contactant les serveurs Google Data.

Créer un nouvel objet de la classe Zend_Gdata ou d'une des classes dérivés disponibles qui offrent des methodes spécifiques pour chaques services.

Le seul paramètre optionnel au constructeur de Zend_Gdata est une instance de Zend_Http_Client. Si vous ne passez pas ce paramètre, Zend_Gdata créera un nouvel objet Zend_Http_Client. Instancier un objet Zend_Http_Client vous permettra de passer des options de configuration à ce dernier.

<?php
require_once 'Zend/Gdata.php';
require_once 'Zend/Http/Client.php';

$client = new Zend_Http_Client();
$client->setConfig( ...options... );

$gdata = new Zend_Gdata($client);
?>

Voir aussi la partie sur l'authentification pour les méthodes de création d'un objet Zend_Http_Client authentifié.

vos pouvez spécifier des paramètres avec Zend_Gdata pour personaliser vos requêtes. Certain paramètres s'appliquent uniquement sur certain services Google Data. Ces paramètres seront documentés plus tards dans les paragraphes des services correspondants. Certain paramètres agisent de façon générique sur tout les services Google Data accessibles. Voici leur description :

Il existe une fonction get pour chaques fonctions set.

<?php
$gdata = new Zend_Gdata();
$gdata->setMaxResults(10);
echo $gdata->getMaxResults();   // returns 10
?>

Zend_Gdata implémente aussi des méthodes getter et setter "magic", vous donnant ainsi la possibilité d'utiliser les noms de ces paramètres en tant que membres virtuels de la classe. Vous pouvez donc utiliser isset() et unset() sur ces membres virtuels.

<?php
$gdata = new Zend_Gdata();
$gdata->maxResults = 10;
echo $gdata->maxResults;        // retourne 10
echo isset($gdata->maxResults); // renvoi "vrai"
unset($gdata->maxResults);      // efface le paramètre
?>

Vous pouvez effacer tous les paramètres en une fois en utilisant la fonction resetParameters(). Ceci est utile si vous réutilisez un objetc Zend_Gdata pour différentes requêtes.

<?php
$gdata = new Zend_Gdata();
$gdata->maxResults = 10;
// ...récupération des entrées...

$gdata->resetParameters();      // efface tous les paramètre
// ...récupérez de nouvelles entrées...
?>

Utilisez la fonction getFeed() pour récupérer le fil d'une URI spécifiée. Cete fonction retourne un objet de type Zend_Feed.

<?php
$gdata = new Zend_Gdata();
$gdata->setQuery('digital camera');
$gdata->setMaxResults(10);
$uri = 'http://www.google.com/base/feeds/snippets'
    . $gdata->getQueryString();
$feed = $gdata->getFeed($uri);
?>

Voir la documentation de Zend_Feed pour plus d'informations sur l'utilisation de cet objet.

Voir les autres charpitres pour les fonctions spécifiques à certains services Google Data. Ces fonctions vous aide à récupérer les données d'un service particulier à partir de son URI.

L'objet Zend_GData possède une fonction post() avec laquelle vous pouvez uploader de nouvelles entrées dans les services Google Data.

Il est à votre charge de construire une chaine XML syntaxiquement et stucturellement correcte pour une entrée d'un service donné. Vous pouvez pour cela vous aider de librairies PHP comme DOM XML ou SimpleXML.

<?php
$gdata = new Zend_Gdata($authenticatedHttpClient);

$xmlString = <<<XML
<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/g/2005#event'></category>
  <title type='text'>Tennis with Beth</title>
  <content type='text'>Meet for a quick lesson.</content>
  <author>
    <name>Jo March</name>
    <email>jo@gmail.com</email>
  </author>
  <gd:transparency
    value='http://schemas.google.com/g/2005#event.opaque'>
  </gd:transparency>
  <gd:eventStatus
    value='http://schemas.google.com/g/2005#event.confirmed'>
  </gd:eventStatus>
  <gd:where valueString='Rolling Lawn Courts'></gd:where>
  <gd:when startTime='2006-04-17T15:00:00.000Z'
    endTime='2006-04-17T17:00:00.000Z'></gd:when>
</entry>
XML;

$xml = new SimpleXMLElement($xmlString);

$myCalendar = 'http://www.google.com/calendar/feeds/default/private/full';
$gdata->post($xml->asXML(), $myCalendar);
?>

Pour transférer des données, vous devze utiliser un objet Zend_Http_Client authentifié que vous aurez créer en utilisant les classes Zend_Gdata_AuthSub ou Zend_Gdata_ClientLogin.

L'objet Zend_Gdata possède la fonction delete() avec laquelle vous pouvez supprimer des entrées sur les services Google Data. Pour cela il faut passer l'identifiant <id> d'une entrée à la methode delete().

<?php
$gdata = new Zend_Gdata($authenticatedHttpClient);
// a Google Data feed
$feedUri = ...;
$feed = $gdata->getFeed($feedUri);
foreach ($feed as $feedEntry) {
    // extract the <id> element
    $id = $feedEntry->id();
    $gdata->delete($id);
}
?>

Vous pouvez aussi utiliser la methode delete() sans identifiant du moment que vous lui passez une URI correcte identifiant une entrée.

<?php
$gdata = new Zend_Gdata($authenticatedHttpClient);
$uri = 'http://www.google.com/calendar/feeds/default/private/entryID';
$gdata->delete($uri);
?>

Dans l'exemple précédent, remplacez "entryID" par l'identifiant de l'entrée que vous voulez supprimer.

Pour supprimer des entrées, vous devez utiliser un objet Zend_Http_Client authentifié que vous aurez céer à l'aide d'une des classes Zend_Gdata_AuthSub ou Zend_Gdata_ClientLogin.