# Zend_Service_Yahoo

## Introduction

`Zend_Service_Yahoo` est une API simple pour utiliser les APIs REST de Yahoo! `Zend_Service_Yahoo` vous permet de rechercher dans Yahoo! Web Search, Yahoo! News, Yahoo! Local et Yahoo! Images. Pour pouvoir utiliser l'API REST de Yahoo!, vous devez avoir un identifiant Yahoo Application. Pour obtenir un identifiant Yahoo Application, veuillez compléter et soumettre le formulaire de demande d'identifiant Yahoo! Application.

## Rechercher sur le Web avec Yahoo!

`Zend_Service_Yahoo` vous permet d'effectuer des recherches sur le net avec Yahoo! en utilisant la méthode `webSearch()`, qui accepte une chaîne de requête en paramètre, et un tableau d'options de recherche comme second paramètre. Pour la liste détaillée des options, veuillez vous référer à la documentation Yahoo! Web Search. La méthode `webSearch()` retourne un objet `Zend_Service_Yahoo_WebResultSet`.

### Rechercher sur le Web avec Yahoo!

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->webSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Trouver des images avec Yahoo!

Vous pouvez rechercher des images avec Yahoo! en utilisant la méthode `imageSearch()` de `Zend_Service_Yahoo`. Cette méthode accepte une chaîne de requête en paramètres, et un tableau d'options en second paramètre optionnel. Pour la liste complète des options, veuillez vous référer à la documentation Yahoo! Image Search.

### Trouver des images avec Yahoo!

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->imageSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Trouver des vidéos avec Yahoo!

Vous pouvez rechercher des vidéos avec Yahoo! en utilisant la méthode `videoSearch()` de `Zend_Service_Yahoo`. Pour la liste complète des options, veuillez vous référer à la documentation Yahoo! Video Search.

### Trouver des vidéos avec Yahoo!

    $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
    $results = $yahoo->videoSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Trouver des entreprises et des services locaux avec Yahoo!

Vous pouvez rechercher des entreprises et des services locaux avec Yahoo!, en utilisant la méthode `localSearch()`. Pour plus de détails, veuillez vous référer à la documentation Yahoo! Local Search.

### Trouver des entreprises locales et des services avec Yahoo!

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->localSearch('Ordinateurs Apple', array('zip' => '95014'));
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Rechercher dans Yahoo! News

Rechercher dans Yahoo! News est simple, il vous suffit simplement d'utiliser la méthode `newsSearch()`, comme le montre l'exemple suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! News Search.

### Recherche dans Yahoo! News

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->newsSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Rechercher avec Yahoo! Site Explorer Inbound Links

Rechercher avec Yahoo! Site Explorer Inbound Links est simple, il vous suffit simplement d'utiliser la méthode `inlinkDataSearch()` comme le montre l'exemple suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! Site Explorer Inbound Links Documentation.

### Recherche avec Yahoo! Site Explorer Inbound Links

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->inlinkDataSearch('http://framework.zend.com/');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Rechercher avec Yahoo! Site Explorer's PageData

Rechercher avec Yahoo! Site Explorer's PageData est simple, il vous suffit simplement d'utiliser la méthode `pageDataSearch()` comme le montre l'exemple suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! Site Explorer PageData Documentation.

### Recherche avec Yahoo! Site Explorer's PageData

    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->pageDataSearch('http://framework.zend.com/');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## Classes Zend_Service_Yahoo

Les classes sont toutes retournées par les diverses recherches Yahoo!. Chaque type de recherche retourne un jeu de résultat spécifique sur lequel on peut facilement itérer, avec chaque résultat contenu dans un résultat du type de l'objet. Toutes les classes de jeu de résultat implémentent l'interface `SeekableIterator`, permettant des itérations et une recherche sur un résultat particulier.

- `Zend_Service_Yahoo_ResultSet`

- `Zend_Service_Yahoo_WebResultSet`

- `Zend_Service_Yahoo_ImageResultSet`

- `Zend_Service_Yahoo_VideoResultSet`

- `Zend_Service_Yahoo_LocalResultSet`

- `Zend_Service_Yahoo_NewsResultSet`

- `Zend_Service_Yahoo_InlinkDataResultSet`

- `Zend_Service_Yahoo_PageDataResultSet`

- `Zend_Service_Yahoo_Result`

- `Zend_Service_Yahoo_WebResult`

- `Zend_Service_Yahoo_ImageResult`

- `Zend_Service_Yahoo_VideoResult`

- `Zend_Service_Yahoo_LocalResult`

- `Zend_Service_Yahoo_NewsResult`

- `Zend_Service_Yahoo_InlinkDataResult`

- `Zend_Service_Yahoo_PageDataResult`

- `Zend_Service_Yahoo_Image`

### Zend_Service_Yahoo_ResultSet

Chaque jeu de résultat spécifique à la recherche est étendu de cette classe de base.

Chaque jeu de résultat spécifique à la recherche retourne un objet Zend_Service_Yahoo_Result spécifique à la recherche.

#### Zend_Service_Yahoo_ResultSet::totalResults()

int `totalResults`

Retourne le nombre de résultats retourné par la recherche.

#### Propriétés

##### Zend_Service_Yahoo_ResultSet

Nom | Type | Description
--- | --- | ---
totalResultsAvailable | int | Nombre total de résultats trouvés.
totalResultsReturned | int | Nombre de résultats pour le jeu de résultat courant.
firstResultPosition | int | Position du premier résultat dans ce jeu, par rapport au nombre total des résultats.

Retour à la liste des classes

### Zend_Service_Yahoo_WebResultSet

`Zend_Service_Yahoo_WebResultSet` représente un jeu de résultat Yahoo! Web Search.

`Zend_Service_Yahoo_WebResultSet` étend Zend_Service_Yahoo_ResultSet.

Retour à la liste des classes

### Zend_Service_Yahoo_ImageResultSet

`Zend_Service_Yahoo_ImageResultSet` représente un jeu de résultat Yahoo! Image Search.

`Zend_Service_Yahoo_ImageResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_VideoResultSet

`Zend_Service_Yahoo_VideoResultSet` représente un jeu de résultat Yahoo! Video Search.

`Zend_Service_Yahoo_VideoResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_LocalResultSet

`Zend_Service_Yahoo_LocalResultSet` représente un jeu de résultats Yahoo! Local Search.

#### Propriétés de Zend_Service_Yahoo_LocalResultSet

Nom | Type | Description
--- | --- | ---
resultSetMapURL | string | L'URL de la page Web contenant une carte graphique contenant tous les résultats affichés dessus.

`Zend_Service_Yahoo_LocalResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_NewsResultSet

`Zend_Service_Yahoo_NewsResultSet` représente un jeu de résultat Yahoo! News Search.

`Zend_Service_Yahoo_NewsResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_InlinkDataResultSet

`Zend_Service_Yahoo_InlinkDataResultSet` représente un jeu de résultat Yahoo! Inbound Link Search.

`Zend_Service_Yahoo_InlinkDataResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_PageDataResultSet

`Zend_Service_Yahoo_PageDataResultSet` représente un jeu de résultat Yahoo! PageData Search.

`Zend_Service_Yahoo_PageDataResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

### Zend_Service_Yahoo_Result

Chaque résultat spécifique à la recherche est étendu de cette classe de base.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_Result

Nom | Type | Description
--- | --- | ---
Title | string | Titre du résultat
Url | string | URL du résultat
ClickUrl | string | URL pour pointer sur ce résultat

Retour à la liste des classes

### Zend_Service_Yahoo_WebResult

Chaque résultat d'une recherche Web est retourné comme un objet `Zend_Service_Yahoo_WebResult`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_WebResult

Nom | Type | Description
--- | --- | ---
Summary | string | Sommaire du résultat
MimeType | string | type Mime du résultat
ModificationDate | string | Timestamp UNIX de la date de la dernière modification du résultat.
CacheUrl | string | URL Yahoo! du cache Web du résultat, s'il existe.
CacheSize | int | Taille du cache.

Retour à la liste des classes

### Zend_Service_Yahoo_ImageResult

Chaque recherche d'image est retournée comme un objet `Zend_Service_Yahoo_ImageResult`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_ImageResult

Nom | Type | Description
--- | --- | ---
Summary | string | Sommaire du résultat
RefererUrl | string | L'URL de la page qui contient l'image
FileSize | int | La taille (en octets) de l'image
FileFormat | string | Le format de l'image (bmp, gif, jpeg, png, etc.)
Height | int | La hauteur de l'image
Width | int | LA largeur de l'image
Thumbnail | Zend_Service_Yahoo_Image | Vignette de l'image

Retour à la liste des classes

### Zend_Service_Yahoo_VideoResult

Chaque recherche de vidéo est retournée comme un objet `Zend_Service_Yahoo_VideoResult`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_VideoResult

Nom | Type | Description
--- | --- | ---
Summary | string | Sommaire du résultat
RefererUrl | string | L'URL de la page qui contient la vidéo
FileSize | int | La taille (en octets) de la vidéo
FileFormat | string | Le format de la vidéo (avi, flash, mpeg, msmedia, quicktime, realmedia, etc.)
Height | int | La hauteur de la vidéo en pixels
Width | int | La largeur de la vidéo en pixels
Duration | int | La durée de la vidéo en secondes
Channels | int | Nombre de canaux audio de la vidéo
Streaming | boolean | La vidéo est-elle en streaming ou pas ?
Thumbnail | Zend_Service_Yahoo_Image | Vignette de la vidéo

Retour à la liste des classes

### Zend_Service_Yahoo_LocalResult

Chaque résultat de recherche locale est retourné dans un objet `Zend_Service_Yahoo_LocalResult`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_LocalResult

Nom | Type | Description
--- | --- | ---
Address | string | Adresse de la rue du résultat
City | string | Ville dans laquelle réside le résultat
State | string | État dans lequel réside le résultat
Phone | string | Numéro de téléphone du résultat
Rating | int | Appréciation des utilisateurs pour ce résultat
Distance | float | Distance entre l'endroit où vous vous trouvez et le résultat
MapUrl | string | L'URL d'une carte pour le résultat
BusinessUrl | string | L'URL du site de l'entreprise, s'il est connu
BusinessClickUrl | string | L'URL pour faire un lien sur le site de l'entreprise, s'il est connu

Retour à la liste des classes

### Zend_Service_Yahoo_NewsResult

Chaque résultat de News Search est retourné comme un objet `Zend_Service_Yahoo_NewsResult`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_NewsResult

Nom | Type | Description
--- | --- | ---
Summary | string | Sommaire du résultat
NewsSource | string | L'entreprise qui a distribué l'article
NewsSourceUrl | string | L'URL de l'entreprise qui a distribué l'article
Language | string | La langue de l'article
PublishDate | string | La date de publication de l'article, au format timestamp UNIX
ModificationDate | string | La date de la dernière modification de l'article, au format timestamp UNIX
Thumbnail | Zend_Service_Yahoo_Image | Miniature de l'image pour cet article, si elle existe

Retour à la liste des classes

### Zend_Service_Yahoo_InlinkDataResult

Chaque résultat de Inbound Link Search est retourné comme un objet `Zend_Service_Yahoo_InlinkDatabResult`.

Retour à la liste des classes

### Zend_Service_Yahoo_PageDataResult

Chaque résultat de Page Data Search est retourné comme un objet `Zend_Service_Yahoo_PageDataResult`.

Retour à la liste des classes

### Zend_Service_Yahoo_Image

Toutes les images retournées, par Yahoo! Image Search ou Yahoo! News Search sont représentées par un objet `Zend_Service_Yahoo_Image`.

#### Propriétés

##### Propriétés de Zend_Service_Yahoo_Image

Nom | Type | Description
--- | --- | ---
Url | string | URL de l'image
Width | int | Largeur de l'image
Height | int | Hauteur de l'image

Retour à la liste des classes