Zend_Service_Yahoo es una API sencilla para usar
muchas de las APIs REST de Yahoo!.
Zend_Service_Yahoo le permite realizar búsquedas en Yahoo! Web search, Yahoo!
News, Yahoo! Local, Yahoo! Images. Para poder usar la API
REST de Yahoo!, debe disponer de un Application ID de Yahoo!. Para obtener un Application
ID, complete y envíe el Application ID Request Form.
Zend_Service_Yahoo le permite buscar en la Web con Yahoo!
utilizando el método webSearch(), el cual acepta un parámetro de
consulta de tipo cadena y un segundo parámetro opcional en forma de array con opciones de
búsqueda. Para obtener detalles completos y una lista de opciones, visite la documentación de Yahoo! Web
Search. El método webSearch() devuelve un objeto
Zend_Service_Yahoo_WebResultSet.
Ejemplo 64.191. Realizar búsquedas en la Web con Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->webSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Puede buscar imágenes con Yahoo utilizando el método imageSearch()
de Zend_Service_Yahoo. Este método acepta un parámetro de
consulta de tipo cadena y un array opcional con opciones de búsqueda, igual que el método webSearch()
. Para obtener detalles completos y una lista de opciones, visite la documentación de Yahoo! Image
Search.
Ejemplo 64.192. Encontrar imágenes con Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->imageSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Puede buscar vídeos con Yahoo utilizando el método videoSearch()
de Zend_Service_Yahoo. Para obtener detalles completos y una lista de opciones,
visite la documentación de Yahoo! Video
Search.
Ejemplo 64.193. Encontrar vídeos con Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->videoSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Puede buscar negocios y servicios locales con Yahoo! utilizando el método
localSearch(). Para obtener detalles completos, consulte la documentación de Yahoo! Local
Search.
Ejemplo 64.194. Encontrar negocios y servicios locales con Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->localSearch('Apple Computers', array('zip' => '95014'));
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Realizar búsquedas en Yahoo! News es sencillo; basta con usar el método
newsSearch(), como en el siguiente ejemplo. Para obtener detalles completos, consulte la documentación de Yahoo! News Search
.
Ejemplo 64.195. Búsquedas en Yahoo! News
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->newsSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Realizar búsquedas de enlaces entrantes en Yahoo! Site Explorer es sencillo; basta con usar
el método inlinkDataSearch(), como en el siguiente ejemplo. Para
obtener detalles completos, consulte la documentación de Yahoo!
Site Explorer Inbound Links.
Ejemplo 64.196. Búsquedas de enlaces entrantes en Yahoo! Site Explorer
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->inlinkDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Realizar búsquedas de PageData en Yahoo! Site Explorer es sencillo; basta con usar
el método pageDataSearch(), como en el siguiente ejemplo. Para obtener
detalles completos, consulte la documentación de Yahoo!
Site Explorer PageData.
Ejemplo 64.197. Búsquedas de PageData en Yahoo! Site Explorer
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->pageDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
echo $result->Title .'<br />';
}
Las siguientes clases son devueltas por las distintas búsquedas de Yahoo!. Cada tipo de
búsqueda devuelve un conjunto de resultados específico para ese tipo, que puede recorrerse
fácilmente, y cada resultado se encapsula en un objeto de resultado de ese tipo. Todas las
clases de conjuntos de resultados implementan la interfaz
SeekableIterator, lo que permite recorrer los resultados con
facilidad y desplazarse a un resultado concreto.
Cada uno de los conjuntos de resultados específicos de cada búsqueda extiende de esta clase base.
Cada uno de los conjuntos de resultados específicos devuelve objetos Zend_Service_Yahoo_Result específicos de la búsqueda.
int totalResults();
Devuelve el número de resultados obtenidos para la búsqueda.
Tabla 64.20. Zend_Service_Yahoo_ResultSet
| Nombre | Tipo | Descripción |
|---|---|---|
| totalResultsAvailable | int | Número total de resultados encontrados. |
| totalResultsReturned | int | Número de resultados en el conjunto de resultados actual |
| firstResultPosition | int | Posición del primer resultado de este conjunto respecto al número total de resultados. |
Zend_Service_Yahoo_WebResultSet representa un conjunto de
resultados de Yahoo! Web Search.
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_ImageResultSet representa un conjunto de
resultados de Yahoo! Image Search.
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_VideoResultSet representa un conjunto de
resultados de Yahoo! Video Search.
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_LocalResultSet representa un conjunto de
resultados de Yahoo! Local Search.
Tabla 64.21. Propiedades de Zend_Service_Yahoo_LocalResultSet
| Nombre | Tipo | Descripción |
|---|---|---|
| resultSetMapURL | string | La URL de una página web que contiene un gráfico de mapa con todos los resultados devueltos representados en él. |
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_NewsResultSet representa un conjunto de
resultados de Yahoo! News Search.
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_InlinkDataResultSet representa un conjunto de
resultados de la búsqueda de enlaces entrantes de Yahoo!.
![]() |
Nota |
|---|---|
|
Zend_Service_Yahoo_PageDataResultSet representa un conjunto de
resultados de la búsqueda PageData de Yahoo!.
![]() |
Nota |
|---|---|
|
Cada uno de los resultados específicos de cada búsqueda extiende de esta clase base.
Cada resultado de Web Search se devuelve como un objeto
Zend_Service_Yahoo_WebResult.
Tabla 64.23. Propiedades de Zend_Service_Yahoo_WebResult
| Nombre | Tipo | Descripción |
|---|---|---|
| Summary | string | Resumen del resultado |
| MimeType | string | Tipo MIME del resultado |
| ModificationDate | string | La fecha de la última modificación del resultado en forma de marca de tiempo UNIX. |
| CacheUrl | string | URL de la caché web de Yahoo! para el resultado, si existe. |
| CacheSize | int | El tamaño de la entrada en caché |
Cada resultado de Image Search se devuelve como un objeto
Zend_Service_Yahoo_ImageResult.
Tabla 64.24. Propiedades de Zend_Service_Yahoo_ImageResult
| Nombre | Tipo | Descripción |
|---|---|---|
| Summary | string | Resumen del resultado |
| RefererUrl | string | La URL de la página que contiene la imagen |
| FileSize | int | El tamaño del archivo de imagen en bytes |
| FileFormat | string | El formato de la imagen (bmp, gif, jpeg, png, etc.) |
| Height | int | La altura de la imagen |
| Width | int | El ancho de la imagen |
| Thumbnail | Zend_Service_Yahoo_Image | Miniatura de la imagen |
Cada resultado de Video Search se devuelve como un objeto
Zend_Service_Yahoo_VideoResult.
Tabla 64.25. Propiedades de Zend_Service_Yahoo_VideoResult
| Nombre | Tipo | Descripción |
|---|---|---|
| Summary | string | Resumen del resultado |
| RefererUrl | string | La URL de la página que contiene el vídeo |
| FileSize | int | El tamaño del archivo de vídeo en bytes |
| FileFormat | string | El formato del vídeo (avi, flash, mpeg, msmedia, quicktime, realmedia, etc.) |
| Height | int | La altura del vídeo en píxeles |
| Width | int | El ancho del vídeo en píxeles |
| Duration | int | La duración del vídeo en segundos |
| Channels | int | Número de canales de audio del vídeo |
| Streaming | boolean | Si el vídeo es de streaming o no |
| Thumbnail | Zend_Service_Yahoo_Image | Miniatura de la imagen |
Cada resultado de Local Search se devuelve como un objeto
Zend_Service_Yahoo_LocalResult.
Tabla 64.26. Propiedades de Zend_Service_Yahoo_LocalResult
| Nombre | Tipo | Descripción |
|---|---|---|
| Address | string | Dirección postal del resultado |
| City | string | Ciudad en la que se encuentra el resultado |
| State | string | Estado en el que se encuentra el resultado |
| Phone | string | Número de teléfono del resultado |
| Rating | int | Valoración enviada por los usuarios para el resultado |
| Distance | float | La distancia hasta el resultado desde la ubicación especificada |
| MapUrl | string | Una URL de un mapa para el resultado |
| BusinessUrl | string | La URL del sitio web del negocio, si se conoce |
| BusinessClickUrl | string | La URL para enlazar con el sitio web del negocio, si se conoce |
Cada resultado de News Search se devuelve como un objeto
Zend_Service_Yahoo_NewsResult.
Tabla 64.27. Propiedades de Zend_Service_Yahoo_NewsResult
| Nombre | Tipo | Descripción |
|---|---|---|
| Summary | string | Resumen del resultado |
| NewsSource | string | La empresa que distribuyó el artículo |
| NewsSourceUrl | string | La URL de la empresa que distribuyó el artículo |
| Language | string | El idioma en el que está escrito el artículo |
| PublishDate | string | La fecha de publicación del artículo en forma de marca de tiempo UNIX |
| ModificationDate | string | La fecha de la última modificación del artículo en forma de marca de tiempo UNIX |
| Thumbnail | Zend_Service_Yahoo_Image | Miniatura de la imagen del artículo, si existe |
Cada resultado de la búsqueda de enlaces entrantes se devuelve como un objeto
Zend_Service_Yahoo_InlinkDatabResult.
Cada resultado de Page Data Search se devuelve como un objeto
Zend_Service_Yahoo_PageDatabResult.
Todas las imágenes devueltas tanto por Yahoo! Image Search como por Yahoo! News Search
se representan mediante objetos Zend_Service_Yahoo_Image
![[Note]](images/note.png)