En el panorama digital en rápida evolución, los libros electrónicos (EPUB) han ganado una inmensa popularidad debido a su conveniencia y accesibilidad. Sin embargo, la gestión de los metadatos de estos libros electrónicos es a menudo un aspecto crucial pero que se pasa por alto. Los metadatos contienen información esencial sobre un libro electrónico, como su título, autor, fecha de publicación y más. En esta publicación de blog, exploraremos cómo utilizar el poder de Java y GroupDocs.Metadata Cloud API para modificar fácilmente los metadatos de libros electrónicos EPUB utilizando una API REST. Además, proporcionaremos instrucciones paso a paso sobre cómo configurar GroupDocs.Metadata Cloud SDK para Java y cambiar las propiedades de los metadatos utilizando etiquetas específicas. Como beneficio adicional, también presentaremos un editor de metadatos EPUB en línea para mejorar su experiencia de administración de metadatos.
Los siguientes puntos se cubrirán en este artículo:
- Configuración del entorno
- Inicializando el Cliente API
- Cambiar metadatos de EPUB en Java usando REST API
- Bonificación: Editor de metadatos EPUB en línea
Configurar el entorno
Requisitos previos:
Antes de profundizar en la implementación, asegúrese de tener implementados los siguientes requisitos previos:
- Kit de desarrollo Java (JDK) instalado.
- Cuenta GroupDocs para obtener credenciales API.
- Conocimientos básicos de API REST y programación Java.
Obtención de credenciales API:
Para comenzar, regístrese para obtener una cuenta en la nube de GroupDocs y cree una aplicación. El panel le proporcionará las credenciales necesarias (App SID y App Key) para autenticar sus solicitudes.
Agregar el SDK de nube GroupDocs.Metadata para Java:
Para incorporar el SDK en su proyecto Java, puede descargar el archivo JAR de la API o instalarlo usando Maven agregando el siguiente repositorio y dependencia en el archivo pom.xml de su proyecto:
Repositorio Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Dependencia de Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Inicializando el cliente API
Para configurar el cliente API, utilice su ID de cliente y su Secreto de cliente en el código que se muestra a continuación:
Cambiar las propiedades de los metadatos de EPUB
Cargando libro electrónico EPUB:
En primer lugar, cargue el libro electrónico EPUB que desea modificar. Puede lograr esto empleando cualquiera de los métodos siguientes para cargar los archivos al almacenamiento en la nube:
- Cargue todos los archivos uno por uno usando Upload File API desde el navegador.
- Usando el panel.
- Cargue mediante programación usando el ejemplo de código que se proporciona a continuación:
Como resultado, los archivos cargados estarán disponibles en la sección de archivos de su panel de control en la nube.
Propiedades comunes de metadatos EPUB:
A continuación se muestran algunas propiedades de metadatos comunes que se encuentran en los archivos EPUB:
- Título: El título del libro electrónico.
- Creador: El autor o creador del eBook.
- Idioma: El idioma del contenido del libro electrónico.
- Editor: El editor del libro electrónico.
- Descripción: Una breve descripción o resumen del eBook.
- Fecha: La fecha de publicación o fecha de creación del libro electrónico.
- Asunto: Palabras clave o frases que describen el contenido del eBook.
- Derechos: Información sobre los derechos y permisos asociados al eBook.
- Colaborador: otros contribuyentes o funciones de los contribuyentes (p. ej., editor, ilustrador).
- Tipo: el tipo de contenido (p. ej., novela, libro de texto).
- Formato: el formato del archivo del libro electrónico (por ejemplo, EPUB).
- Identificador: un identificador único para el libro electrónico (por ejemplo, ISBN, DOI).
- Cobertura: La cobertura geográfica o temporal del contenido del libro electrónico.
- Fuente: La fuente del contenido del libro electrónico (si corresponde).
Cambiar metadatos EPUB en Java usando la API REST
Estos son los pasos y el código de muestra que muestran cómo cambiar los metadatos de EPUB en Java usando la API REST.
- Cree un objeto de configuración con MyAppSid y MyAppKey.
- Inicialice una instancia de MetadataApi utilizando la configuración creada.
- Cree un objeto SetOptions para configurar los ajustes de metadatos.
- Inicialice una ArrayList de objetos SetProperty para contener propiedades de metadatos.
- Cree un objeto SetProperty para representar una única propiedad de metadatos.
- Cree un objeto SearchCriteria para definir criterios de búsqueda para metadatos.
- Cree un objeto TagOptions para especificar opciones de etiqueta exactas con una etiqueta y una categoría.
- Cree un objeto Etiqueta y establezca su nombre en “Creador” y categoría en “Persona”.
- Establezca la etiqueta exacta en TagOptions usando la Etiqueta creada.
- Establezca los criterios de búsqueda utilizando las TagOptions creadas.
- Establezca el nuevo valor de metadatos, escriba y agregue la propiedad a la lista de propiedades. 7
- Configure la información del archivo, incluida la ruta del archivo EPUB.
- Cree una SetRequest usando las opciones.
- Finalmente, llame al método set en la instancia MetadataApi y almacene la respuesta SetResult.
El siguiente ejemplo de código muestra cómo cambiar los metadatos de EPUB en Java usando la API REST.
Descargar el archivo Epub resultante
El código proporcionado en el paso anterior guarda el archivo resultante en la nube. Para descargarlo, puede utilizar el siguiente fragmento de código.
Bonificación: edite metadatos EPUB en línea
Características:
- Interfaz de usuario intuitiva
- Vista previa en tiempo real de los cambios de metadatos
- Soporte para múltiples propiedades de metadatos EPUB
- Compatibilidad multiplataforma
Cómo utilizar:
- Abra la herramienta GroupDocs.Metadata en el navegador.
- Cargue o arrastre el archivo EPUB.
- Revisar y editar metadatos.
- Guarde y descargue el EPUB actualizado.
Conclusión
En esta publicación de blog, repasamos el proceso de configuración del SDK, inicialización del cliente API y cambio de propiedades de metadatos con etiquetas específicas. Como guinda del pastel, presentamos un editor de metadatos EPUB en línea como beneficio adicional, que ofrece una interfaz fácil de usar para una manipulación de metadatos sin problemas. Aprovecha el poder de la gestión de metadatos y eleva tu colección de libros electrónicos a nuevas alturas.
El SDK de GroupDocs.Metadata Cloud basado en Java simplifica el procedimiento y proporciona una variedad de opciones de personalización. Siéntase libre de explorar la documentación, experimentar con diferentes configuraciones y modificar los metadatos de sus imágenes o documentos para alinearlos perfectamente con los requisitos de su marca.
Además, descubrirá una sección dedicada referencia de API que facilita la visualización e interacción directa con nuestras API directamente a través de su navegador web. El extenso código fuente del SDK de Java está disponible abiertamente en Github.
Al final, nuestro compromiso sigue centrado en crear contenido de blog nuevo que gire en torno a formatos de archivo únicos y su análisis a través de REST API. Manténgase conectado para conocer las actualizaciones más recientes. ¡Le deseamos éxito y satisfacción en sus esfuerzos de codificación!
Hacer una pregunta
En caso de que tenga alguna consulta o confusión sobre el editor de metadatos EPUB, no dude en contactarnos a través de nuestro foro.
Ver también
Aquí hay algunos artículos relacionados que pueden resultarle útiles: