Créer un flux

Le flux multimédia est un objet JSON qui contient une collection d'entités représentant le contenu multimédia de votre catalogue, comme des séries TV, des films, des chansons, des albums, etc. La première étape du processus d'intégration consiste à commencer à développer vos flux. Une fois les fichiers prêts, vous devez héberger le flux à l'aide de l'une des méthodes d'hébergement compatibles pour que Google puisse le récupérer régulièrement.

Exigences concernant le format des fichiers de flux

Voici les exigences concernant les fichiers de flux :

  • Le fichier de flux doit comporter l'extension de nom de fichier .json.
  • Ne chiffrez pas votre fichier de flux.
  • Encodez votre fichier de flux au format UTF-8 (vérifiez les paramètres de votre éditeur de fichiers).

    alt_text

  • Si votre fichier de flux dépasse 1 Go (non compressé), divisez-le en plusieurs fichiers.

  • Nous vous recommandons de créer un fichier par type d'entité (par exemple, tvseries.json, tvseasons.json, tvepisodes.json, movies.json, etc.).

    • Si l'un de ces fichiers dépasse 1 Go, divisez ses entités en plusieurs fichiers (par exemple, tvepisodes_01.json, tvepisodes_02.json, etc.).
    • Tant que la taille du fichier est inférieure à 1 Go, il n'y a pas de limite au nombre d'entités que vous pouvez inclure dans un même fichier.
  • Assurez-vous que le fichier est encodé sans BOM, conformément à la spécification JSON. Pour vérifier un OS Linux, hexdump file.json | head -n 1 ne doit pas commencer par BBEF à l'adresse 0x00.

Types de flux

Flux de production

  • Il s'agit de l'ensemble des fichiers de flux JSON qui, ensemble, représentent l'intégralité du catalogue que vous souhaitez lancer sur Google. Pour savoir comment créer un flux, consultez la section ci-dessous.
  • Il s'agit du seul flux dont vous avez besoin si vous intégrez Google pour la première fois.
  • Une fois ce flux envoyé à Google, il sera analysé en détail et modifié à plusieurs reprises pour atteindre un niveau de qualité plus élevé en ce qui concerne la quantité d'informations capturées et leur exactitude, avant d'être finalement ingéré et lancé.

Flux de préproduction

  • Certains cas d'utilisation nécessitent l'extension du flux de production. Voici quelques exemples de scénarios :
    • Extension du flux pour inclure de nouveaux types d'entités qui n'avaient pas été lancés auparavant.
    • Extension du flux pour inclure un grand nombre de nouvelles entités/métadonnées à lancer dans de nouveaux paramètres régionaux.
    • Expansion du flux vers de nouveaux types de plates-formes Par exemple, lorsque le flux de production n'est lancé que sur la recherche Google et que vous souhaitez maintenant l'étendre à Google TV.
  • Dans ce cas, un flux de préproduction est requis. Ce flux est une copie du flux de production, à l'exception du fait qu'il comporte des métadonnées supplémentaires, par exemple des liens profonds pour une nouvelle plate-forme, des métadonnées pour de nouveaux paramètres régionaux, etc.
  • Comme pour le flux de production, ce flux sera analysé en détail et répété plusieurs fois pour atteindre un niveau de qualité plus élevé en ce qui concerne la quantité d'informations capturées et leur exactitude. Une fois le niveau de qualité atteint, ce flux remplace le flux de production actuel pour devenir le nouveau flux de production.
  • Ce flux nous permet de séparer le lancement initial des lancements supplémentaires, et d'effectuer tous les tests requis sans affecter le flux de production. Cela permet d'éviter toute interruption de l'expérience de l'utilisateur final.

Contactez votre représentant Google pour toute question sur les points ci-dessus.

Créer un fichier de flux

Suivez ces bonnes pratiques lorsque vous créez le flux :

  1. Créer un exemple de flux à l'aide d'un petit ensemble d'entités

    Avant de créer un flux contenant l'intégralité du contenu de votre catalogue, nous vous recommandons de créer un exemple de flux ne contenant qu'un petit ensemble d'entités. Lorsque vous travaillez sur votre flux, vous êtes susceptible de rencontrer des problèmes. En limitant la taille de l'ensemble d'entités, vous pourrez déboguer ces erreurs et avertissements plus facilement.

  2. Valider l'exemple de flux

    Nous fournissons des outils qui garantissent que votre flux est conforme aux spécifications. Nous vous recommandons d'utiliser ces outils pour résoudre toutes les erreurs et tous les avertissements détectés dans votre exemple de flux.

  3. Créer un flux de production

    Après avoir vérifié que la structure de votre petit ensemble d'entités est correcte, développez un flux pour l'ensemble de votre catalogue.

Créer un exemple de flux

  1. Sélectionnez une entité représentative dans votre catalogue. Choisissez une entité dont la structure est raisonnablement complexe, mais qui reste typique d'une entité du catalogue.
  2. Utilisez l'outil de validation de schéma JSON pour vérifier les erreurs de syntaxe et les propriétés obligatoires manquantes. (Pour en savoir plus, consultez la section suivante.)

    Exemple de flux avec une seule entité Movie

    {
      "@context": "http://schema.org",
      "@type": "DataFeed",
      "dateModified": "2018-07-20T00:44:51Z",
      "dataFeedElement": [
        {
          "@context": ["http://schema.org", {"@language": "en"}],
          "@type": "Movie",
          "@id": "http://www.example.com/my_favorite_movie",
          "url": "http://www.example.com/my_favorite_movie",
          "name": "My Favorite Movie",
          "potentialAction": {
            "@type": "WatchAction",
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
              "inLanguage": "en",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform",
                "http://schema.googleapis.com/GoogleVideoCast"
              ]
            },
            "actionAccessibilityRequirement": {
              "@type": "ActionAccessSpecification",
              "category": "subscription",
              "requiresSubscription": {
                "@type": "MediaSubscription",
                "name": "Example Package",
                "commonTier": true,
                "@id": "[partner determined string]"
              },
              "availabilityStarts": "2018-07-21T10:35:29Z",
              "availabilityEnds": "2019-10-21T10:35:29Z",
              "eligibleRegion": [
                {
                  "@type": "Country",
                  "name": "US"
                },
                {
                  "@type": "Country",
                  "name": "CA"
                }
              ]
            }
          },
          "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
          "releasedEvent": {
            "@type": "PublicationEvent",
            "startDate": "2008-01-20",
            "location": {
              "@type": "Country",
              "name": "US"
            }
          },
          "description": "This is my favorite movie.",
          "actor": [
            {
              "@type": "Person",
              "name": "John Doe",
              "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
            },
            {
              "@type": "Person",
              "name": "Jane Doe",
              "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
            }
          ],
          "identifier": [
            {
              "@type": "PropertyValue",
              "propertyID": "IMDB_ID",
              "value":  "tt0123456"
            }
          ]
        }
      ]
    }

Valider l'exemple de flux

Les outils suivants sont disponibles pour vous aider à valider un exemple de flux par rapport aux spécifications de données structurées de Google pour les flux multimédias :

  • Outil de validation de schéma JSON

    L'outil de validation de schéma JSON valide tous les fichiers d'un flux localement avant l'importation. Utilisez cet outil lors du développement du flux pour éviter les erreurs courantes de structure et de type. Pour en savoir plus sur cet outil, cliquez ici.

  • Propriétés de catalogue dans la Search Console

    Une fois que votre représentant Google a activé votre propriété de catalogue Search Console et que votre exemple de flux ou votre flux de préproduction a été ingéré, utilisez les propriétés de catalogue dans la Search Console pour inspecter les erreurs de validation, les avertissements et les diagnostics d'ingestion au niveau de l'entité.

Créer un flux de production

  1. Une fois que toutes les erreurs et tous les avertissements structurels du flux d'exemple ont été résolus, développez le flux pour inclure toutes les entités de votre catalogue.
  2. Exécutez l'outil de validation de schéma JSON sur vos fichiers de flux développés et examinez les propriétés de catalogue dans la Search Console après l'importation pour vérifier qu'il n'y a pas d'erreurs de validation. Vérifiez que votre flux inclut toutes les entités de votre catalogue en comparant le nombre d'entités de votre flux au nombre d'articles de votre catalogue.