Données structurées pour les actions sur les livres (Book)

Les actions sur les livres font de la recherche Google un point d’entrée pour découvrir des livres et des auteurs. Cela permet aux utilisateurs de la recherche d’acheter ou d’emprunter rapidement les livres qu’ils trouvent directement à partir des résultats de recherche. Par exemple, un utilisateur peut rechercher Charlotte’s Web et se voir présenter des résultats qui lui permettent d’acheter ou d’emprunter le livre. En tant que fournisseur de livres, vous pouvez fournir un flux de données à Google avec le schéma de données structurées fourni ici. Notre spécification fournit
ReadAction pour permettre aux utilisateurs d’acheter un livre et BorrowAction pour emprunter un livre.

Les actions de lecture et d’emprunt, qui sont intégrées aux panneaux, affichent des options pour acheter ou emprunter le livre. Grâce aux liens que vous fournissez, les actions de lecture et d’emprunt envoient les utilisateurs directement depuis le panneau de connaissances et d’autres surfaces Google vers une page de livre sur votre site Web ou votre application.

L’ordre des fournisseurs dans le panneau de connaissances est personnalisé et dynamique pour chaque utilisateur. Cela signifie que différents utilisateurs voient des classements différents, et le même utilisateur peut voir des classements différents à des moments différents. Il existe une variété de facteurs qui affectent un classement donné. Par exemple, si un utilisateur clique souvent sur un lien de fournisseur donné dans le panneau de connaissances, ce fournisseur est plus susceptible d’être positionné plus haut dans un classement. Il n’y a aucun moyen de contrôler l’ordre.

Démarrer

Pour implémenter avec succès les actions sur les livres, vous devez créer votre flux conformément aux définitions de type de données structuréesdes actions sur les livres, mais examinez d’abord les sections suivantes :

• Directives
• Créez votre flux
• Testez votre flux avec l’outil de validation de flux de données
• Hébergez votre fichier de flux
• Soumettez votre fichier de flux pour examen
• Mettez à jour votre flux si nécessaire

Directives

Pour garantir que vos livres puissent être affichés de manière fiable dans la recherche, il est important que vous soyez familiarisé avec certains détails importants et concepts clés. De plus, votre flux doit répondre à certaines spécifications de format standardisées.

Pour vous aider à le faire, suivez les directives décrites ici, en plus des
directives générales sur les données structurées et des
Search Essentials. Les directives sont les suivantes :

• Œuvres et éditions
• Systèmes de bibliothèques et membres de bibliothèques
• ISBN et autres identifiants pris en charge
• Liens

Œuvres et éditions

Tout au long de cette documentation, nous utilisons deux termes distincts lorsque nous parlons d’un livre :

• Œuvre: Le concept abstrait d’un livre. Plus précisément, les métadonnées telles que le titre, l’auteur et la langue originale sont des attributs d’une œuvre.
• Édition: Une copie concrète du livre. Plus précisément, les métadonnées telles que l’année de publication, le nom de l’édition et le numéro international normalisé du livre (ISBN) sont des attributs de l’édition.

Par exemple, Charlotte’s Web est une œuvre, mais chaque variété dans laquelle il se décline est une édition. Dans ce cas, l’œuvre Charlotte’s Web pourrait avoir une première édition, une deuxième édition, une édition abrégée, une édition traduite en français, et ainsi de suite.

Cette distinction est particulièrement importante dans le flux où elle peut ne pas être immédiatement évidente. Il existe deux entités Livre Livre:

• Œuvre (est l'entité) Livre de "niveau supérieur" :
  workExample
  • est une propriété de Œuvre et spécifie une et une seule instance d'une Livre Édition (Il doit y avoir au moins un).
  • workExample pour chaque Œuvre Livre.
• Édition (est l'entité) Livre de "niveau inférieur".
  Il est utile de se rappeler qu’il peut y avoir plusieurs éditions d’une œuvre. Nous vous recommandons de regrouper ces éditions autant que possible. Cela aide les systèmes Google à tirer parti de toutes les informations pertinentes sur un livre et à l’afficher dans la recherche. Si vous le devez, vous pouvez les diviser en plusieurs enregistrements d’œuvre, mais chaque enregistrement d’œuvre doit comporter les éléments suivants :

Un

• @id différent.
• Au moins une édition avec un ISBN ou un autre identifiant pris en charge.

Systèmes de bibliothèques et membres de bibliothèques

La entité de bibliothèque est le “niveau supérieur” Bibliothèque type d’entité. Il s’agit d’une construction abstraite, qui se compose d’une Système de bibliothèques entité et de chaque “niveau inférieur”
Bibliothèque (membre) entité de ce système de bibliothèques.

La Système de bibliothèques entité est une abstraction et représente un réseau collaboratif de membresde bibliothèque. Par exemple, la bibliothèque publique d’Austin peut être spécifiée comme une
Système de bibliothèques entité. Le site Web de la bibliothèque publique d’Austin se décrit comme un système de bibliothèques publiques qui dessert Austin, au Texas. Il se compose de ses 20 bibliothèques affiliées, ou membres.

de bibliothèque. Chaque Système de bibliothèques entité nécessite au moins une Bibliothèque (membre)
entité, même si dans la réalité la bibliothèque ne fait partie d’aucun système de bibliothèques. Dans ce scénario, aux fins de la mise en œuvre de l’action Livre, la bibliothèque est le seul
membre de bibliothèque de son propre systèmede bibliothèques. Aux fins de la mise en œuvre de l’action Livre, contrairement à un systèmede bibliothèques, un membre de bibliothèque n’est pas une abstraction et possède donc une adresse physique.

À l’inverse, chaque Bibliothèque (membre) entité doit appartenir à au moins une
Système de bibliothèques entité.

ISBN et autres identifiants pris en charge

L’ISBN est le principal signal de rapprochement lorsque la recherche Google fait correspondre les données de votre flux avec les données de Google. Vous devez fournir un ISBN ou un autre identifiant pris en charge pour tous les livres que vous souhaitez voir apparaître dans les résultats de recherche. Sans cela, il est probable que vos livres ne puissent pas être mis en correspondance et ne seront donc pas diffusés.

La recherche Google préfère l’ISBN-13, mais vous pouvez alternativement fournir les éléments suivants :

• Numéro de l’Online Computer Library Center (OCLC)
• Numéro de contrôle de la Bibliothèque du Congrès (LCCN)
• Code JP e-code

identifiant pris en charge provenant d’une autre édition.

Ajoutez des identifiants tiers. La recherche Google prend actuellement en charge deux numéros de contrôle de bibliothèque largement utilisés : le numéro OCLC ou le LCCN. Si vous possédez l’un ou l’autre, fournissez-le.

• Liens
  Pour vous assurer que les utilisateurs bénéficient de la meilleure expérience possible lors de la recherche de vos livres, les liens dans votre flux doivent respecter les directives suivantes : Si vous avez des pages en double pour le même contenu, le lien doit être l’
• URL canonique

qui contient le titre du livre et d’autres

L’utilisation de cette fonctionnalité est limitée aux fournisseurs de livres qui ont
rempli le formulaire d'intérêt et ont été intégrés.

Si votre site vend des livres aux utilisateurs, vous devez télécharger votre flux de
Livre . Une équipe d’assistance Google vous contactera avec des détails sur la façon et l’endroit où télécharger votre flux.
Si votre site prête des livres aux utilisateurs, vous devez télécharger deux flux distincts : votre flux de Livre

et votre flux de

Bibliothèque

• . Une équipe d’assistance Google vous contactera avec des détails sur la façon et l’endroit où télécharger votre flux.
  • Respectez les exigences relatives à la taille, à la quantité et au format du fichier de flux
  • Les exigences sont les suivantes : Exigences relatives à la taille du fichier de flux : La taille d’un fichier de flux non compressé doit être inférieure à 1 Go. Un fichier de flux destiné à être compressé doit être inférieur à 1 Go. Si votre fichier de flux non compressé dépasse 1 Go, vous devez diviser le fichier de flux non compressé en plusieurs fichiers.
• Vous pouvez compresser les fichiers de flux. Ils doivent être formatés en fichier d’archive zip, gz, tar, tar.gz, JAR, ar, arj, cpio ou dump.
• Si vous avez plusieurs fichiers de flux, vous pouvez les télécharger tels quels ou, si vous préférez, les inclure dans un
  fichier d’index de sitemap.
• Les fichiers de flux uniques doivent avoir l’extension .json de fichier.

Respectez les exigences relatives au contenu du flux

Soyez particulièrement attentif aux exigences suivantes concernant le contenu du flux, que vous devez respecter :

• Le flux ne doit pas contenir d’entités obsolètes. Les entités obsolètes sont des entités dont
  availabilityEnds est fixé à une date passée ou des entités qui ne sont plus disponibles sur votre site.
• Tous les liens profonds, tels que urlTemplate, et toutes les URL, telles que
  url, que vous incluez dans votre flux doivent être des URL de production. N’utilisez pas d’URL de QA, de développement ou tout autre type d’URL hors production.
• Toutes les URL, telles que url, doivent être
  canoniques.
• Chaque entité de votre flux doit spécifier les propriétés suivantes :
  • Un ID unique : @id
  • Une URL unique : url
  • Un lien profond unique : urlTemplate

Testez votre flux avec l’outil de validation Data Feed

Nous recommandons les étapes de dépannage suivantes pour résoudre les erreurs et avertissements courants dans l’outil de validation Data Feed:

• Assurez-vous que l’option correcte est sélectionnée dans le champ Validate on Sélectionnez Books Action pour l’entité Book Vérifiez que la valeur de

• @type est correctement orthographiée. Assurez-vous que la valeur de
• @context est correctement définie. Définissez “@context”: “https://schema.org”
  à la fois pour ReadAction et BorrowAction
  Hébergez votre fichier de flux.

Lorsque votre fichier de flux est prêt, hébergez-le dans un emplacement sécurisé. Google récupère le flux régulièrement pour s’assurer que votre contenu est à jour.

Méthodes d’hébergement

Les méthodes d’hébergement de flux suivantes sont prises en charge :

Hébergement

Pour que votre contenu soit disponible sur la recherche Google, une équipe de support Google examine la qualité des liens profonds dans votre flux. Nous vous recommandons vivement de tester manuellement certains des liens profonds pour confirmer s’ils ouvrent la page où les utilisateurs peuvent acheter ou emprunter les livres.

Remarque :

Emplacement de l’hôte :

• L’URL de votre fichier de flux. Authentification de l’hôte, le cas échéant :
• Les informations d’identification d’authentification pour permettre à Google d’obtenir le fichier de flux depuis votre emplacement d’hôte. Mettez à jour votre flux si nécessaire. Nous vous recommandons de mettre à jour votre flux quotidiennement, mais cela dépend en fin de compte de la fréquence à laquelle votre catalogue change. Soyez conscient des conditions et conseils suivants : La recherche Google ne prend pas en charge les mises à jour en temps réel. La recherche Google récupère votre flux une fois par jour et indexe généralement le contenu dans les deux jours. S’il y a un changement prévisible dans la disponibilité d’une édition, utilisez es

es

es

• es
• es
• es
  availabilityStarts et availabilityEnds
  pour définir les dates exactes. Si l’entité n’est plus disponible, supprimez-la complètement.

Définitions des types de données structurées

Vous devez inclure les propriétés requises listées ici pour que votre contenu puisse être éligible à l’affichage dans les résultats de recherche structurés. Vous pouvez également inclure les propriétés recommandées pour ajouter plus d’informations sur votre contenu, ce qui peut offrir une meilleure expérience utilisateur.

Entité DataFeed

Chaque fichier de flux de données schema.org envoyé à Google doit contenir une seule entité de type
DataFeed au niveau racine. Toutes les entités
Book et
Library doivent être listées sous le champ
dataFeedElement de l’entité DataFeed .

Les propriétés prises en charge par Google sont les suivantes :

Livre entité

Bien que la définition complète de Livre soit disponible sur
schema.org/Book, vous n’avez besoin de prendre en compte que les propriétés suivantes. Vous devez définir les propriétés requises pour chaque livre que vous choisissez d’inclure dans votre flux. Vous pouvez également définir des propriétés recommandées pour ajouter plus d’informations sur votre contenu, ce qui peut offrir une meilleure expérience utilisateur.

Livre (Œuvre)

Cette Livre entité est le type d’entité de niveau supérieur. Elle représente une œuvre.

Les propriétés prises en charge par Google sont les suivantes :

Livre (Édition)

La workExample propriété utilise cette Livre entité. Elle représente une
édition d’une œuvre.

Les propriétés prises en charge par Google sont les suivantes :

Exemple Livre (Édition):

Exemple Livre (Édition) avec plusieurs workExample propriétés :

Personne ou Organisation (auteur)

La auteur propriété du livre utilise l’entité
Personne ou Organisation .

Exemple auteur:

Exemple avec plusieurs auteur propriétés :

PropertyValue (identifiant)

La identifiant propriété de l’ Édition utilise l’entité PropertyValue
.

Exemple identifiant:

Exemple avec plusieurs identifiant propriétés :

Exemple ReadAction Livre fichier JSON de flux

Exemple BorrowAction Livre fichier JSON de flux

ReadAction (potentialAction)

La potentialAction propriété utilise l’entité ReadAction .
ReadAction définit vos liens profonds pour accéder au livre, le détaillant qui stocke le livre et les critères que les utilisateurs doivent remplir. Les critères peuvent inclure le statut d’adhésion, le statut de connexion, l’emplacement ou tout autre élément requis pour accéder au livre.

à trois lettres. Exemple:

ReadAction Exemple ReadAction avec plusieurs EntryPoint

propriétés : (BorrowAction)

potentialAction La propriété potentialAction utilise l'entité BorrowAction
. BorrowAction

Le lien qui amène les utilisateurs directement au contenu de la page de destination de votre livre. Exemple:

BorrowAction Exemple BorrowAction avec plusieurs Point d'entrée propriétés :

Bibliothèque entité

Bien que la définition complète de Bibliothèque soit disponible sur
schema.org/Library,
vous n’avez besoin de prendre en compte que les propriétés suivantes. Vous devez définir les
propriétés requises pour chaque bibliothèque que vous choisissez d’inclure dans votre flux.
Vous pouvez également définir des propriétés recommandées pour ajouter plus d’informations sur
votre contenu, ce qui peut offrir une meilleure expérience utilisateur.

Cette Bibliothèque entité est le type d’entité Bibliothèque
de niveau supérieur. Il s’agit d’une construction abstraite, qui consiste en une
SystèmeDeBibliothèques entité et chaque
Bibliothèque (membre) entité de niveau inférieur de ce
SystèmeDeBibliothèques.

Le Bibliothèque flux est distinct du Livre flux. Par conséquent, tout Bibliothèque
flux que vous pourriez implémenter doit être entièrement séparé de votre Livre flux.
Pour plus d’informations, reportez-vous à
Créez votre flux.

SystèmeDeBibliothèques

L’entité SystèmeDeBibliothèques représente un réseau collaboratif
de membres.

Bibliothèque (membre)

La membre propriété de l’entité LibrarySystem utilise l’entité Bibliothèque (membre) entité.
Bibliothèque (membre) représente une seule bibliothèque membre
d’un système de bibliothèque donné système.

Exemple LibrarySystem fichier JSON de flux