Cette page a été traduite par l'API Cloud Translation.

Créer un flux

Le flux multimédia est un objet JSON qui contient un ensemble d'entités qui représentent le contenu multimédia de votre catalogue (séries TV, films, titres musicaux, albums, etc.). La première étape consiste à commencer à développer vos flux. Une fois que les fichiers sont prêts, vous devez héberger le flux à l'aide de l'une des méthodes d'hébergement acceptées pour que Google les récupère régulièrement.

Exigences relatives au format des fichiers de flux

Les exigences concernant les fichiers de flux sont les suivantes :

Le fichier du flux doit porter 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 l'éditeur de fichiers).
Divisez le fichier en plusieurs fichiers si la taille de votre flux est supérieure à 1 Go (non compressé).
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, scindez 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, le nombre d'entités que vous pouvez inclure dans un fichier est illimité.
Vérifiez que le fichier est codé sans BOM, conformément à la spécification JSON. Pour vérifier sur un système d'exploitation 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'ensemble de votre 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 procédez à l'intégration à Google pour la première fois.
Une fois ce flux envoyé à Google, il fait l'objet d'une analyse et d'itérations répétées à plusieurs reprises afin d'obtenir une barre de meilleure qualité avec la quantité d'informations capturées et son exactitude avant d'être enfin ingérée et lancée.

Flux de préproduction

Dans certains cas d'utilisation, le flux de production doit être développé. Voici quelques exemples :
- Extension du flux pour inclure de nouveaux types d'entités, qui n'ont pas encore été lancés.
- Extension du flux pour inclure un très grand nombre de nouvelles entités/métadonnées à lancer dans de nouveaux paramètres régionaux.
- Extension du flux à de nouveaux types de plates-formes. Par exemple, lorsque le flux de production n'est lancé que dans 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, sauf qu'il contient des métadonnées supplémentaires (par exemple, des liens profonds pour une nouvelle plate-forme, des métadonnées pour un nouveau paramètre régional, etc.).
Comme pour le flux de production, ce procédé sera analysé à plusieurs reprises et itéré à plusieurs reprises pour atteindre une barre de meilleure qualité avec la quantité d'informations capturées et leur exactitude. Une fois la barre de qualité atteinte, 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 de ne pas perturber l'expérience utilisateur.

Adressez-vous à votre représentant Google pour obtenir des réponses à toutes les questions ci-dessus.

Créer un fichier de flux

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

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

Avant de créer un flux contenant tout le contenu de votre catalogue, nous vous recommandons de créer un exemple de flux avec seulement un petit ensemble d'entités. Lorsque vous travaillez sur votre flux, vous risquez de rencontrer des problèmes. En limitant la taille de l'ensemble d'entités, vous pourrez déboguer ces erreurs et ces avertissements plus facilement.
Valider l'exemple de flux

Nous fournissons des outils qui permettent de vérifier que votre flux respecte les 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.
Créer un flux de production

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

Créer un exemple de flux

Sélectionnez une entité représentative dans votre catalogue. Choisissez une entité dont la structure est relativement complexe, mais qui reste la norme pour une entité du catalogue.

Utilisez l'outil de validation de flux de données pour rechercher 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 avec les spécifications de données structurées de Google pour les flux multimédias.

Outil de validation des flux de données

L'outil de validation de flux de données permet de valider une seule entité à la fois. Utilisez cet outil pour valider un exemple d'entité de votre catalogue afin d'identifier les erreurs de structure et les erreurs de contenu courantes. Pour en savoir plus sur l'outil, cliquez ici.
Outil de validation de schémas JSON

L'outil de validation du schéma JSON peut valider tous les fichiers d'un flux. Utilisez cet outil pendant le développement du flux pour éviter les erreurs de structure courantes. Pour en savoir plus sur l'outil, cliquez ici.

Créer un flux de production

Une fois les erreurs et les avertissements corrigés, développez le flux pour inclure toutes les entités de votre catalogue.
Utilisez fréquemment l'outil de validation de flux de données pour valider un petit nombre d'entités de votre flux à la fois. Le fait de coller un grand nombre d'entités dans l'outil peut figer le navigateur Web. Vérifiez que votre flux inclut toutes les entités de votre catalogue en comparant le nombre d'entités dans votre flux avec le nombre d'éléments de votre catalogue.

Identifier le prix

Héberger le flux