Las acciones de libros hacen de la Búsqueda de Google un punto de entrada para descubrir libros y autores. Esto permite a los usuarios de la Búsqueda comprar o tomar prestados rápidamente los libros que encuentran directamente desde los resultados de búsqueda. Por ejemplo, un usuario puede buscar Charlotte’s Web y recibir resultados que le permitan comprar o tomar prestado el libro. Como proveedor de libros, puede proporcionar un feed de datos a Google con el esquema de datos estructurados que se proporciona aquí. Nuestra especificación proporciona
ReadAction para permitir que los usuarios compren un libro y BorrowAction para tomar prestado un libro.
Las acciones de lectura y préstamo, que se incorporan a los paneles, muestran opciones para comprar o tomar prestado el libro. A través de los enlaces que usted proporciona, las acciones de lectura y préstamo envían a los usuarios directamente desde el panel de conocimiento y otras superficies de Google a una página de libro en su sitio web o aplicación.
El orden de los proveedores en el panel de conocimiento es personalizado y dinámico para cada usuario. Esto significa que diferentes usuarios ven diferentes ordenamientos, y el mismo usuario puede ver diferentes ordenamientos en diferentes momentos. Hay una variedad de factores que afectan un ordenamiento determinado. Por ejemplo, si un usuario hace clic a menudo en un enlace de proveedor determinado en el panel de conocimiento, es más probable que ese proveedor se posicione más alto en un ordenamiento. No hay forma de controlar el orden.
Primeros pasos
Para implementar con éxito las acciones de libros, debe crear su feed de acuerdo con las definiciones de tipo de datos estructuradosde acciones de libros, pero primero revise las siguientes secciones:
- Directrices
- Cree su feed
- Pruebe su feed con la herramienta de validación de Data Feed
- Aloje su archivo de feed
- Envíe su archivo de feed para su revisión
- Actualice su feed según sea necesario
Directrices
Para garantizar que sus libros puedan aparecer de forma fiable en la Búsqueda, es importante que esté familiarizado con algunos detalles importantes y conceptos clave. Además, su feed debe cumplir con algunas especificaciones de formato estandarizadas.
Para ayudarle a hacerlo, siga las directrices descritas aquí, además de las
directrices generales de datos estructurados y las
Search Essentials. Las directrices son las siguientes:
- Obras y ediciones
- Sistemas bibliotecarios y miembros de bibliotecas
- ISBN y otros identificadores admitidos
- Enlaces
Obras y ediciones
A lo largo de esta documentación, utilizamos dos términos distintos cuando hablamos de un libro:
- Obra: El concepto abstracto de un libro. Específicamente, los metadatos como el título, el autor y el idioma original son atributos de una obra.
- Edición: Una copia concreta del libro. Específicamente, los metadatos como el año de publicación, el nombre de la edición y el Número Internacional Normalizado del Libro (ISBN) son atributos de la edición.
Por ejemplo, Charlotte’s Web es una obra, pero cada variedad en la que viene es una edición. En este caso, la obra Charlotte’s Web podría tener una primera edición, segunda edición, edición abreviada, edición de traducción al francés, etcétera.
Esta distinción es especialmente importante en el feed, donde puede no ser inmediatamente obvia. Hay dos entidades Libro Libro:
Obra(es la entidad) Librode "nivel superior":
workExamplees una propiedad deObray especifica una y solo una instancia de unaLibroEdición(Debe haber al menos un).- workExample
para cadaObraLibro.
Edición(es la entidad) Librode "nivel inferior".
Es útil recordar que puede haber múltiples ediciones de una obra. Le recomendamos que agrupe estas ediciones tanto como sea posible. Esto ayuda a los sistemas de Google a aprovechar toda la información relevante sobre un libro y mostrarla en la Búsqueda. Si es necesario, puede dividirlas en varios registros de obra, pero cada registro de obra debe tener lo siguiente:
Un
- @id
diferente. - Al menos una edición con un ISBN u otro identificador admitido.
Sistemas bibliotecarios y miembros de bibliotecas
La entidad de biblioteca es el “nivel superior” Biblioteca tipo de entidad. Es un constructo abstracto que consiste en una Sistema de bibliotecas entidad y cada “nivel inferior”
Biblioteca (miembro) entidad de ese sistema de bibliotecas.
La Sistema de bibliotecas entidad es una abstracción y representa una red colaborativa de miembrosde bibliotecas. Por ejemplo, la Biblioteca Pública de Austin puede especificarse como una
Sistema de bibliotecas entidad. El sitio web de la Biblioteca Pública de Austin se describe a sí mismo como un sistema de bibliotecas públicas que sirve a Austin, Texas. Consta de sus 20 bibliotecas afiliadas, o miembros.
de biblioteca. Cada Sistema de bibliotecas entidad requiere al menos una Biblioteca (miembro)
entidad, incluso si en la vida real la biblioteca no forma parte de ningún sistema de bibliotecas. En este escenario, para los fines de la implementación de la acción de Libro, la biblioteca es el único
miembro de biblioteca de su propio sistemade bibliotecas. Para los fines de la implementación de la acción de Libro, a diferencia de un sistemade bibliotecas, un miembro de biblioteca no es una abstracción y, por lo tanto, tiene una dirección física.
Por el contrario, cada Biblioteca (miembro) entidad debe pertenecer al menos a una
Sistema de bibliotecas entidad.
ISBN y otros identificadores admitidos
El ISBN es la principal señal de conciliación cuando la Búsqueda de Google compara los datos de su feed con los datos de Google. Debe proporcionar un ISBN u otro identificador admitido para todos los libros que desee que aparezcan en los resultados de búsqueda. Sin él, es probable que sus libros no puedan coincidir y, por lo tanto, no se mostrarán.
La Búsqueda de Google prefiere ISBN-13, pero alternativamente puede proporcionar lo siguiente:
- Número del Online Computer Library Center (OCLC)
- Número de control de la Biblioteca del Congreso (LCCN)
- Código JP e-code
identificador admitido de otra edición.
Agregue identificadores de terceros. La Búsqueda de Google actualmente admite dos números de control de biblioteca ampliamente utilizados: número OCLC o LCCN. Si tiene alguno de estos, proporciónelo.
- Enlaces
Para asegurarse de que las personas tengan la mejor experiencia al encontrar sus libros, los enlaces en su feed deben cumplir con las siguientes pautas: Si tiene páginas duplicadas para el mismo contenido, el enlace debe ser la - URL canónica
que contiene el título del libro y otra
El uso de esta función está limitado a los proveedores de libros que han
completado el formulario de interés y han sido incorporados.
Si su sitio vende libros para que los usuarios los compren, debe cargar su feed de
Libro . Un equipo de soporte de Google se comunicará con usted con detalles sobre cómo y dónde cargar su feed.
Si su sitio presta libros para que los usuarios los tomen prestados, debe cargar dos feeds separados: su feed de Libro
y su feed de
Biblioteca
- . Un equipo de soporte de Google se comunicará con usted con detalles sobre cómo y dónde cargar su feed.
- Cumpla con los requisitos de tamaño de archivo, cantidad y formato del feed
- Los requisitos son los siguientes: Requisitos de tamaño de archivo del feed: El tamaño de un archivo de feed sin comprimir debe ser inferior a 1 GB. Un archivo de feed que se va a comprimir debe ser inferior a 1 GB. Si su archivo de feed sin comprimir supera 1 GB, debe dividir el archivo de feed sin comprimir en varios archivos.
- Puede comprimir archivos de feed. Deben estar formateados en un archivo de almacenamiento zip, gz, tar, tar.gz, JAR, ar, arj, cpio o dump.
- Si tiene varios archivos de feed, puede subirlos tal cual o, si lo prefiere, puede incluirlos como parte de un
archivo de índice de sitemap. - Los archivos de feed individuales deben tener la
.jsonextensión de archivo.
Cumpla con los requisitos de contenido del feed
Tenga especial cuidado con los siguientes requisitos de contenido del feed que debe cumplir:
- El feed no debe contener entidades obsoletas. Las entidades obsoletas son entidades con
availabilityEndsestablecido en una fecha que ya pasó o entidades que ya no están disponibles en su sitio. - Todos los enlaces profundos, como
urlTemplate, y todas las URL, como
url, que incluya en su feed deben ser URL de producción. No utilice URL de QA, desarrollo o cualquier otro tipo de URL que no sea de producción. - Todas las URL, como
url, deben ser
canónicas. - Cada entidad en su feed debe especificar las siguientes propiedades:
- Un ID único:
@id - Una URL única:
url - Un enlace profundo único:
urlTemplate
- Un ID único:
Pruebe su feed con la herramienta de validación de Data Feed
Recomendamos los siguientes pasos de solución de problemas para resolver errores y advertencias comunes en la herramienta de validación de Data Feed:
Asegúrese de tener seleccionada la opción correcta en el campo Validate on Seleccione Books Action para la entidad
BookVerifique que el valor de- @type
esté escrito correctamente.Asegúrese de que el valor de - @context
esté configurado correctamente. Establezca“@context”: “https://schema.org”
tanto paraReadActioncomo paraBorrowAction
Aloje su archivo de feed.
Cuando su archivo de feed esté listo, alójelo en una ubicación segura. Google obtiene el feed regularmente para garantizar que su contenido esté actualizado.
Métodos de alojamiento
Se admiten los siguientes métodos de alojamiento de feed:
Alojamiento
| Soporte de autenticación | Google Cloud Storage | |
|---|---|---|
| Permiso de | Storage Object Viewer HTTPS | |
| Nombre de usuario+Contraseña o | Certificados de cliente HTTP SFTP | |
| Contraseña, Clave+Frase o ambos | AWS S3 | |
| ID de clave+Clave de acceso | Envíe su archivo de feed para su revisión | |
Para que su contenido esté disponible en la Búsqueda de Google, un equipo de soporte de Google revisa la calidad de los enlaces profundos en su feed. Recomendamos encarecidamente que pruebe manualmente algunos de los enlaces profundos para confirmar si abren la página donde los usuarios pueden comprar o pedir prestados los libros.
Nota:
Ubicación del host:
- La URL de su archivo de feed. Autenticación del host, si corresponde:
- Las credenciales de autenticación para permitir que Google obtenga el archivo de feed de su ubicación de host. Actualice su feed según sea necesario. Recomendamos que actualice su feed diariamente, pero esto depende en última instancia de la frecuencia con la que cambie su catálogo. Tenga en cuenta las siguientes condiciones y consejos: La Búsqueda de Google no admite actualizaciones en tiempo real. La Búsqueda de Google obtiene su feed una vez al día y normalmente indexa el contenido en un plazo de dos días. Si hay un cambio previsible en la disponibilidad de una edición, utilice fr
fr
fr
- fr
- fr
- fr
availabilityStartsyavailabilityEnds
para establecer las fechas exactas. Si la entidad ya no está disponible, elimínela por completo.
Definiciones de tipos de datos estructurados
Debe incluir las propiedades obligatorias enumeradas aquí para que su contenido pueda aparecer en los resultados de búsqueda estructurados. También puede incluir las propiedades recomendadas para añadir más información sobre su contenido, lo que puede proporcionar una mejor experiencia al usuario.
Entidad DataFeed
Cada archivo de feed de datos de schema.org enviado a Google debe contener una única entidad de
DataFeed en el nivel raíz. Todas las entidades
Book y
Library deben incluirse en el campo
dataFeedElement de la entidad DataFeed .
Las propiedades admitidas por Google son las siguientes:
| Propiedades obligatorias | |
|---|---|
@context | Establecer en |
@type | Establecer en |
dataFeedElement | Establecer en una sola entidad Ejemplo de uso en un feed de Ejemplo de uso en un feed de |
dateModified | La fecha y hora de la última actualización del feed en el |
Libro entidad
Si bien la definición completa de Libro está disponible en
schema.org/Book, solo necesita considerar las siguientes propiedades. Debe definir las propiedades requeridas para cada libro que elija incluir en su feed. También puede definir propiedades recomendadas para agregar más información sobre su contenido, lo que puede proporcionar una mejor experiencia de usuario.
Libro (Obra)
Esta Libro entidad es el tipo de entidad de nivel superior. Representa una obra.
Las propiedades admitidas por Google son las siguientes:
| Propiedades requeridas | |
|---|---|
@context | Establecido en |
@id | Un ID globalmente único para el libro en formato URL. Debe ser único para su organización. El ID debe ser estable y no cambiar con el tiempo. Se sugiere el formato URL, aunque no es obligatorio. No tiene que ser un enlace que funcione. El dominio utilizado para el |
@type | Establecido en |
autor | El autor(es) del libro. |
nombre | El título del libro. |
url | La URL en su sitio web donde se presenta o describe el libro. Este enlace ayuda a conciliar con precisión el contenido de su feed con el contenido de las bases de datos de Google. Puede ser el mismo que . Para la página de destino real, la Búsqueda de Google utiliza la URL proporcionada en |
workExample |
La edición(es) de la obra. |
| Propiedades recomendadas | |
|---|---|
sameAs | La URL de una página de referencia que identifica la obra. Por ejemplo, una página de Wikipedia, Wikidata, VIAF o la Biblioteca del Congreso para el libro. |
Libro (Edición)
La workExample propiedad utiliza esta Libro entidad. Representa una
edición de una obra.
Las propiedades compatibles con Google son las siguientes:
| Propiedades obligatorias | |
|---|---|
@id | Un ID globalmente único para el libro en formato URL. Debe ser único para su organización. El ID debe ser estable y no cambiar con el tiempo. Se sugiere el formato URL, aunque no es obligatorio. No tiene que ser un enlace funcional. El dominio utilizado para el |
@type | Establecer en |
bookFormat | El formato de la edición. El valor de esto debe ser uno de los siguientes:
|
inLanguage | El idioma principal del contenido en la edición. Utilice uno de los códigos de dos letras de la lista de códigos ISO 639-1 alpha-2. |
isbn | El ISBN-13 de la edición. Si tiene ISBN-10, conviértalo a ISBN-13. |
potentialAction | La acción que se activará para que los usuarios compren o descarguen el libro. Para más detalles, consulte |
| Propiedades recomendadas | |
|---|---|
author | El autor(es) de la edición. |
. | Texto |
2nd Edition | Fecha La fecha de publicación de la edición en formato YYYY-MM-DD o |
. Esto puede ser una fecha específica o solo un año específico. | identifier |
Esta propiedad se puede repetir. | Texto |
El título de la edición. Utilice esto solo cuando el título de la edición sea diferente del título de la obra. | URL |
url | La URL en su sitio web donde se presenta o describe la edición. Puede ser la misma que |
Ejemplo Libro (Edición):
Ejemplo Libro (Edición) con múltiples workExample propiedades:
Persona o Organización (autor)
La autor propiedad del libro utiliza la
Persona o Organización entidad.
| Propiedades requeridas | |
|---|---|
@type | Establecer en |
nombre | El nombre de la persona u organización. |
| Propiedades recomendadas | |
|---|---|
sameAs | La URL de una página web de referencia que indica inequívocamente la identidad de la persona u organización. Por ejemplo, una página de Wikipedia para la persona u organización. |
Ejemplo autor:
Ejemplo con múltiples autor propiedades:
PropertyValue (identificador)
La identificador propiedad de la Edición utiliza la PropertyValue
entidad.
| Propiedades requeridas | |
|---|---|
@type | Establecer en |
propertyID | El tipo de ID. Como se describe en
|
valor | El valor de la ID. La ID externa que identifica inequívocamente esta edición. Elimine todos los prefijos no numéricos de la ID externa. |
Ejemplo identificador:
Ejemplo con múltiples identificador propiedades:
Ejemplo ReadAction Libro archivo JSON de feed
Ejemplo BorrowAction Libro archivo JSON de feed
ReadAction (potentialAction)
La potentialAction propiedad utiliza la ReadAction entidad.
ReadAction define sus enlaces profundos para acceder al libro, el minorista que tiene el libro y los criterios que los usuarios deben cumplir. Los criterios pueden incluir el estado de membresía, el estado de inicio de sesión, la ubicación o cualquier otra cosa necesaria para acceder al libro.
| Propiedades requeridas | |
|---|---|
@type | Establecido en |
expectsAcceptanceOf | La definición de los requisitos del usuario para acceder a esta entidad. Si hay varias Esta propiedad se puede repetir. |
expectsAcceptanceOf.@type | Establecido en |
expectsAcceptanceOf.category | El tipo de
|
expectsAcceptanceOf.eligibleRegion | El país que es elegible para esta Esta propiedad se puede repetir. |
expectsAcceptanceOf.eligibleRegion.@type | Establecido en |
expectsAcceptanceOf.eligibleRegion.name | El ISO 3166-1 alpha-2 código de país. |
target | Las especificaciones de su enlace profundo, que incluye la información de la plataforma compatible. Puede haber múltiples Esta propiedad se puede repetir. |
target.@type | Establecido en |
target.actionPlatform | La(s) plataforma(s) para las que es válido este enlace profundo. Utilice uno de los siguientes valores:
Esta propiedad se puede repetir. |
target.urlTemplate | El enlace que lleva a los usuarios directamente al contenido de la página de destino de su libro. |
| Propiedades recomendadas | |
|---|---|
expectsAcceptanceOf.availabilityEnds | La hora de finalización de la ventana de disponibilidad. Esto se puede utilizar para controlar el momento exacto en el que este libro ya no debe mostrarse a los usuarios. |
expectsAcceptanceOf.availabilityStarts | La hora de inicio de la ventana de disponibilidad. Esto se puede utilizar para controlar el momento exacto en el que este libro puede mostrarse a los usuarios. |
expectsAcceptanceOf.price | El precio de compra del libro. Esto es obligatorio cuando la propiedad |
. |
Text |
de tres letras. Ejemplo:
ReadAction Ejemplo ReadAction con múltiples EntryPoint
propiedades: (BorrowAction)
potentialAction La propiedad potentialAction utiliza la entidad BorrowAction
. BorrowAction
| define sus enlaces profundos para acceder al libro, la biblioteca que tiene el libro y los criterios que los usuarios deben cumplir. Los criterios pueden incluir el estado de membresía, el estado de inicio de sesión, la ubicación o cualquier otra cosa necesaria para acceder al libro. | |
|---|---|
Propiedades requeridas | Text |
BorrowAction | LibrarySystem |
El sistema bibliotecario que proporciona acceso a esta edición. | URL |
, que deben describirse completamente por separado en el feed de la biblioteca. | Text |
LibrarySystem | EntryPoint . |
Esta propiedad se puede repetir. | Text |
EntryPoint | Text
https://schema.org/IOSPlatform |
Esta propiedad se puede repetir. | URL |
El enlace que lleva a los usuarios directamente al contenido de la página de destino de su libro. Ejemplo:
BorrowAction Ejemplo BorrowAction con múltiples Punto de entrada propiedades:
Biblioteca entidad
Si bien la definición completa de Biblioteca está disponible en
schema.org/Library,
solo necesita considerar las siguientes propiedades. Debe definir las
propiedades requeridas para cada biblioteca que elija incluir en su feed.
También puede definir propiedades recomendadas para agregar más información sobre
su contenido, lo que puede proporcionar una mejor experiencia de usuario.
Esta Biblioteca entidad es el tipo de entidad Biblioteca
de nivel superior. Es una construcción abstracta que consiste en una
SistemaDeBibliotecas entidad y cada
Biblioteca (miembro) entidad de nivel inferior de ese
SistemaDeBibliotecas.
El Biblioteca feed es distinto del Libro feed. Por lo tanto, cualquier Biblioteca
feed que pueda implementar debe estar completamente separado de su Libro feed.
Para obtener más información, consulte
Cree su feed.
SistemaDeBibliotecas
La entidad SistemaDeBibliotecas representa una red colaborativa
de miembros.
| de nivel inferior en su implementación. | |
|---|---|
Propiedades requeridas | @contextTexto |
https://schema.org | @idURL |
debe ser propiedad de su organización. | @typeTexto |
SistemaDeBibliotecas | propiedadAdicionalValorDePropiedad |
La propiedad adicional utilizada para indicar el tipo de la biblioteca. | propiedadAdicional.@typeTexto |
ValorDePropiedad | propiedadAdicional.nombreTexto |
tipodebiblioteca | TextoEl tipo de biblioteca. Utilice uno de los siguientes valores:
|
miembro | BibliotecaEl miembro o los miembros del sistema bibliotecario. |
nombre | TextoEl nombre del sistema bibliotecario. Por ejemplo, |
url | URLLa URL donde se presenta o describe el sistema bibliotecario. La Búsqueda de Google utiliza este enlace para conciliar el contenido de su feed con el contenido de las bases de datos de Google. Para la página de destino real, la Búsqueda de Google utiliza la URL proporcionada en |
Biblioteca (miembro)
La miembro propiedad de la LibrarySystem entidad utiliza la Biblioteca (miembro)
entidad. Biblioteca (miembro) representa una sola biblioteca
miembro de un sistema bibliotecario dado.
| de nivel inferior en su implementación. | |
|---|---|
Propiedades requeridas | @idURL |
valor | debe ser propiedad de su organización.@type |
Establecer en | Bibliotecaubicación PostalAddress Ejemplo Estados Unidos |
Ejemplo Japón | ubicaciónlocation.@type |
Establecer en | PostalAddresslocation.addressCountry |
. Por ejemplo, | USlocation.addressLocality |
La localidad. Por ejemplo, | Mountain Viewlocation.addressRegion |
fr | frEl código postal. Por ejemplo, |
location.streetAddress | TextoLa dirección postal. Por ejemplo, |
nombre | TextoEl nombre de la sucursal de la biblioteca. |
Ejemplo LibrarySystem archivo JSON de feed
Cómo lo aplicamos
Book actions serve publishers and retailers with catalogue depth. We implement it where a client sells or lists books at scale, not for occasional mentions.
Servicios relacionados