Publicación de gadgets

En este documento se describen las distintas opciones que tienes para publicar tu gadget. Si utilizas el Editor de gadgets de Google (Google Gadgets Editor, GGE) para crear y alojar tus gadgets, te será mucho más fácil publicarlos.

Contenido

  1. ¿Dónde puedo poner mi gadget?
  2. Preparación para la publicación
    1. Pruebas de altura y ancho
    2. Mejora del rendimiento de los gadgets
  3. Publicación en el directorio de contenido de iGoogle
    1. Administración de los gadgets enviados

¿Dónde puedo poner mi gadget?

Puedes poner tus gadgets en cualquiera de los siguientes lugares:

  • en los contenedores de OpenSocial que admiten gadgets como, por ejemplo, orkut y la zona de pruebas de iGoogle,
  • el directorio de contenido de Google (sólo gadgets heredados). Al enviar tu gadget al directorio de contenido, estará disponible para un mayor número de usuarios.

No todos los gadgets son aptos para todos los entornos. Para obtener información detallada sobre las funciones admitidas en cada entorno, consulta la documentación de tu contenedor.

Preparación para la publicación

Antes de publicar tu gadget, debes probarlo, teniendo en cuenta los requisitos y las limitaciones del entorno de destino en el que se ejecutará el gadget.

Se deben hacer las pruebas siguientes en todos los gadgets:

  • Prueba todas las combinaciones de valores UserPref.
  • Ejecútalo en pantallas de diferente tamaño, desde 800x600 hasta la máxima resolución de que dispongas. Te recomendamos la extensión para desarrolladores web de Firefox, que te permitirá ajustar fácilmente el tamaño de Firefox a un tamaño determinado.
  • Prueba tus gadgets en diferentes tamaños, como se describe en Pruebas de altura y ancho.
  • Prueba tu gadget en todos los entornos compatibles.
  • Prueba tu gadget en los siguientes navegadores: Internet Explorer 7, Internet Explorer 6, Firefox 2.x, Firefox 1.5.x, IE 7, IE 6, Opera 9.x y Safari 2.x.
  • Prueba diferentes tamaños de fuente:
    • Para cambiar el tamaño de la fuente en Firefox, selecciona Herramientas > Opciones > Contenido. Haz clic en Avanzadas en el área "Tipos y colores". Cambia la configuración de la fuente y desactiva la casilla "Permitir a las páginas elegir sus propios tipos de letra, en vez de mi selección anterior".
    • Para cambiar el tamaño de la fuente en Internet Explorer, selecciona Herramientas > Opciones de Internet > General. Puedes cambiar la configuración de la fuente en los cuadro de diálogo Fuentes y Accesibilidad.

Si utilizas makeRequest(), comprueba qué ocurre si la fuente de datos no está disponible o si se produce un error. Para simular esta situación, cambia la URL por otra temporalmente.

Pruebas de altura y ancho

El tamaño que se le debe asignar a un gadget depende en gran parte de cómo se ejecute. Para obtener información detallada, consulta la documentación de tu contenedor.

Al diseñar y probar los gadgets, debes estar preparado para anchos arbitrarios desde 200 hasta 600 píxeles. Para algunos gadgets, el ancho deberá ser aún mayor. Como norma general, diseña el gadget para que se muestre correctamente aunque se añada espacio adicional. Por ejemplo, los gadgets de mapas deben rellenar sus áreas, los gadgets de imágenes deben centrarse automáticamente en el marco y el texto de los gadgets de texto deben flotar en la parte superior (por ejemplo, los enlaces de "haz clic aquí para obtener más información" que suelen aparecer en la parte inferior deben permanecer cerca del contenido en vez de flotando en la parte inferior de la ventana del gadget).

Mejora del rendimiento de los gadgets

Si creas un gadget que crees que va a experimentar un tráfico muy intenso, puedes seguir unos pasos para garantizar su disponibilidad y buen rendimiento. Si tu gadget obtiene más de 200.000 visualizaciones al día, o aproximadamente 1-2 solicitudes cada segundo, debes considerar los consejos incluidos en esta sección. Incluso un gadget de 50 KB que reciba 200.000 solicitudes al día consumirá alrededor de 300 GB al mes en ancho de banda.

Existen varias razones por las que un gadget puede atraer a un gran número de usuarios. Puede ser simplemente debido a que se haya hecho popular en el directorio de contenido. O bien, si el gadget se utiliza en alguna promoción o anuncio especial, eso podría hacer que experimente un tráfico intenso.

Tu objetivo para los gadgets con tráfico intenso debe ser que consiga representarse en 0,25 segundos (250 milisegundos) como máximo. Puedes medirlo con Firebug (sólo para Firefox). Mejoras la capacidad de respuesta de tu gadget siempre tendrá un impacto positivo en la experiencia del usuario. Para obtener consejos sobre cómo optimizar el rendimiento de tu gadget, consulta Optimización para tráfico intenso. Para obtener consejos sobre administración, consulta Administración del tráfico intenso. Las directrices para pruebas generales también son de especial importancia para gadgets de gran popularidad.

Optimización para tráfico intenso

Si crees que tu gadget podría experimentar un tráfico intenso, sigue estas directrices:

  • Evita el uso de archivos CSS o JavaScript externos (archivos identificados por los atributos "src" o "href" en las etiquetas HTML), ya que implica otra conexión a la red. En su lugar, incluye código CSS y JavaScript en línea en la especificación del gadget.
  • Utiliza un gadget type=html. Por lo general, los gadgets el tipo type=url son más lentos que los del tipo type=html debido al bajo rendimiento y los limitados recursos de caché de otros servidores de alojamiento.
  • El método makeRequest() almacena tu contenido en la memoria caché durante aproximadamente 1-2 horas de forma predeterminada. Puedes utilizar el parámetro refreshInterval con estas funciones para actualizar la memoria caché más a menudo. Sin embargo, el almacenamiento en caché mejora el rendimiento, ya que minimiza el número de solicitudes enviadas al contenido de alojamiento de servidores remotos. No solicite una frecuencia de actualización de la memoria caché mayor de la necesaria o reducirá el porcentaje de solicitudes enviadas desde la memoria caché. Para obtener información más detallada sobre este tema, consulta Actualización de la memoria caché.
  • Ajusta el rendimiento de tu gadget con Firebug (sólo para Firefox). Para otros navegadores, puedes utilizar Fiddler.
  • Intenta no utilizar Google Analytics si es posible, ya que implica la conexión a un servidor adicional. En lugar de Google Analytics, utiliza http://www.google.com/ig/directory?url=<gadget-url> para ver las visitas semanales a la página de tu gadget.
  • Especifica la altura y el ancho de todas las etiquetas <img> del código HTML de tu gadget. Esto hará que tu gadget se represente con mayor rapidez. Si utilizas gadgets.io.getProxyUrl() e insertas el elemento de imagen directamente en el DOM, no tendrás que establecer las propiedades de altura y ancho.
  • En lugar de vincular directamente tu proveedor de servicios de alojamiento, utiliza las funciones gadgets.io.getProxyUrl() para almacenar en caché todas las imágenes insertadas y embedCachedFlash() para almacenar en caché el contenido Flash. A continuación te mostramos un ejemplo de un gadget que utiliza gadgets.io.getProxyUrl() para cargar previamente las imágenes:

En este gadget de ejemplo se muestra cómo utilizar gadgets.io.getProxyUrl():

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Zombies!" height="350" />
  <Content type="html">
  <![CDATA[
  <div id="zombiecontainer"
    style="text-align:center;">
  </div>
  <script type="text/javascript">
  var counter = 0;

  // Preload the images using gadgets.io.getProxyUrl()
  function load(imageList) {
    var ret = [];
    for (var i = 0, j = imageList.length; i < j; ++i) {
      var img = document.createElement("img");
      img.src = gadgets.io.getProxyUrl(imageList[i]);
      ret.push(img);
    }
    return ret;
  }

  var files = [
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-0.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-1.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-2.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-3.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-4.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-5.jpg",
    "http://gadget-doc-examples.googlecode.com/svn/trunk/zombie-6.jpg"
  ];

  var images = load(files);
  browse();

  // Browse through photos sequentially. When you get to the end of the array, start over.
  function browse(){
    if (counter == images.length)
    {
      counter = 0;
    }
    document.getElementById("zombiecontainer").innerHTML = "";
    document.getElementById("zombiecontainer").appendChild(images[counter]);
    counter++;
  }

  </script>
  <br />
  <div style="text-align: center;">
    <input type=submit value="Next ->" onClick="browse()">
  </div>
  ]]>
  </Content>
</Module>

Administración del tráfico intenso

Estas directrices te ayudarán a administrar los gadgets de mayor volumen:

  • Si vas a recibir grandes cantidades de correo electrónico de los usuarios de tu gadget, utiliza Gmail para establecer filtros que te ayuden a administrar el volumen. Te recomendamos que utilices una dirección del tipo <username>.feedback+<gadgetname>@gmail.com en la especificación de tu gadget. Esto te ayudará a filtrar los mensajes que recibas de los usuarios del gadget. Gmail desechará todo lo que aparezca después del signo (+), por lo que esta dirección de correo electrónico se asigna a <username>.feedback@gmail.com. Ten en cuenta que Gmail dispone de un filtro de spam de gran calidad.
  • Si envías tu gadget al directorio de contenido de iGoogle, consulta los comentarios de los usuarios en la página de descripción de tu gadget periódicamente. Los usuarios dejan a menudo informes de errores que han detectado, solicitudes de funciones y comentarios que pueden serte de gran utilidad. Te recomendamos que te mantengas al día de sus comentarios y te comuniques con ellos.

Publicación en el directorio de contenido de iGoogle

Una vez que hayas designado, implementado y probado tu gadget, podrás enviarlo a Google para publicarlo en el directorio de contenido de Google. Actualmente, esto sólo se aplica a los gadgets heredados. En esta sección se especifican los pasos generales que deberás seguir para preparar los gadgets que desees publicar.

Paso 1: establece las preferencias del gadget

En la referencia se incluyen todos los atributos <ModulePrefs> que podrás utilizar para proporcionar metadatos sobre tu gadget. Deberás incluir esta información en la especificación de tu gadget:

  • title
  • description. Este atributo es importante para informar a los usuarios sobre lo que hace tu gadget, especialmente si no es algo obvio.
  • author
  • author_email. Este atributo permitirá a Google y a los usuarios de tu gadget ponerse en contacto contigo. Puedes utilizar cualquier sistema de correo electrónico, pero debes evitar emplear una dirección personal si no quieres recibir spam. Una opción es utilizar una dirección de correo electrónico del tipo helensmith.feedback+coolgadget@gmail.com en la especificación de tu gadget. Gmail desechará todo lo que aparezca después del signo (+), por lo que esta dirección de correo electrónico se asigna a helensmith.feedback@gmail.com. Puedes crear una cuenta de Gmail a través de esta página.
  • screenshot. Esta cadena especifica la URL de una captura de pantalla del gadget. Debe ser una URL de formato correcto, no una URL relativa. Esta imagen debe ser de un sitio web público que no esté bloqueado por ningún archivo robots.txt. PNG es el formato recomendado, aunque también se aceptan GIF y JPG. El ancho de las capturas de pantalla del gadget debe ser de 280 píxeles. La altura deber ser la altura "real" del gagdet cuando está en uso. Esto ayudará a los usuarios a saber cuánto espacio ocupa un gadget en la pantalla antes de añadirlo a su página. La captura de pantalla debe tener algo de espacio en blanco sobre la barra de encabezado azul del gadget. Las capturas de pantalla muestran el gadget completo, incluida la barra de título, pero nada más. También puedes crear una captura de pantalla del gadget con la ventana de edición abierta. Las capturas de pantalla no se pueden recortar ni se debe cambiar su tamaño. Por calidad y consistencia, Google puede elegir sus propias capturas de pantalla de un determinado gadget.
  • thumbnail. Las miniaturas se utilizan en el directorio de contenido para ofrecer a los usuarios una vista previa de un gadget. Deben representar las funciones principales del gadget sin mostrarlo en su totalidad. El valor de este atributo es una cadena que especifica la URL de una miniatura del gadget. Debe ser una URL de formato correcto, no una URL relativa. Esta imagen debe ser de un sitio web público que no esté bloqueado por ningún archivo robots.txt. PNG es el formato recomendado, aunque también se aceptan GIF y JPG. Las miniaturas deben tener 120x60 píxeles. No deben incluir barras de título.
  • author_location
  • author_affiliation
  • title_url. Este atributo permite vincular el título de tu gadget con una página HTML externa. Por ejemplo, si tu gadget es la interfaz de usuario de un servicio, puedes vincular el título del gadget con el sitio web de dicho servicio.
  • directory_title (obligatorio si el título contiene variables de sustitución de preferencias del usuario).

Si quieres aparecer en la página de autores, puedes incluir estos campos adicionales:

  • author_photo. La URL de una fotografía (el formato recomendado es PNG de 70x100, pero también se admiten JPG y GIF).
  • author_aboutme. Información sobre ti (no debe sobrepasar los 500 caracteres).
  • author_link. Enlace a tu sitio web, blog, etc.
  • author_quote. Una cita que quieras incluir (no debe sobrepasar los 300 caracteres).

Dispones de más información aquí y de un ejemplo aquí.

Paso 2: asegúrate de haber creado un gadget seguro y completo

Asegúrate de haber codificado tu gadget para minimizar cualquier riesgo de seguridad.

Paso 3: añade cualquier información relevante sobre configuraciones regionales

Puedes utilizar las etiquetas <Locale> de <ModulePrefs> para especificar las configuraciones regionales que admitirá tu gadget. Para obtener más información, consulta ModulePrefs/Locale en la referencia XML.

Paso 4: haz que a los usuarios les resulte fácil añadir tu gadget

Para promocionar tu gadget, considera la posibilidad de añadir un botón "Añadir a Google".

Paso 5: envía tu gadget a Google

Puedes enviar tu gadget a Google aquí. También puedes enviar tu gadget al directorio de contenido mediante el comando "Archivo > Publicar" de GGE. La sección Preguntas frecuentes contiene una explicación sobre cómo buscar un gadget en el directorio y qué factores determinan su ubicación.

Administración de los gadgets enviados

Si has enviado varias versiones de un gadget a distintas direcciones URL y quieres designar una versión como la oficial, puedes utilizar el servicio de registro y seguimiento de problemas heredados de iGoogle para solicitar el cambio.

Volver al principio