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

Créer un flux

Le flux média est un objet JSON qui contient un ensemble d'entités qui représentent le contenus multimédias de votre catalogue, tels que des séries TV, des films, des titres, des albums, etc. La première étape du processus d'intégration 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 le récupère régulièrement.

Exigences relatives au format des fichiers de flux

Voici les exigences à respecter pour le ou les fichiers de flux :

Le fichier de 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 votre éditeur de fichiers).
Divisez le fichier en plusieurs fichiers si la taille du fichier de 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, divisez ses entités en plusieurs (par exemple, tvepisodes_01.json, tvepisodes_02.json, etc.).
- Tant que la taille du fichier est inférieure à 1 Go, vous pouvez inclure autant d'entités que vous le souhaitez dans un seul fichier.
Assurez-vous que le fichier est encodé sans nomenclature, conformément à la spécification JSON. Pour effectuer une vérification 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 représentent ensemble l'ensemble de votre catalogue que vous souhaitez lancer sur Google. Vous pouvez découvrir comment créer un flux dans la section ci-dessous.
Il s'agit du seul flux dont vous avez besoin si vous effectuez une intégration à Google pour la première fois.
Une fois ce flux envoyé à Google, il est analysé de manière approfondie et itéré sur quelques pour atteindre un niveau de qualité supérieur par rapport à la quantité d'informations collectées et avant qu'elles ne soient ingérées et lancées.

Flux de préproduction

Dans certains cas d'utilisation, il est nécessaire d'étendre le flux de production. Quelques exemples des scénarios suivants:
- Extension du flux pour inclure de nouveaux types d'entités qui n'ont pas encore été lancés
- Expansion du flux pour inclure un grand nombre de nouvelles entités/métadonnées à lancer dans de nouvelles paramètres régionaux.
- Expansion du flux à de nouveaux types de plates-formes. Par exemple, lorsque le flux de production n'est sur la recherche Google et vous souhaitez l'étendre à Google TV.
Dans ce cas, un flux de préproduction est requis. Ce flux est une copie du flux de production, Elle comporte des métadonnées supplémentaires, telles que des liens profonds pour une nouvelle plate-forme ou des métadonnées pour de nouveaux paramètres régionaux. et ainsi de suite.
Comme pour le flux de production, il sera analysé et répété plusieurs fois afin de atteindre un niveau de qualité supérieur par rapport à 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 un nouveau flux de production.
Ce flux nous permet de distinguer le lancement initial des lancements supplémentaires, d'effectuer toutes les tests requis, sans affecter le flux de production. Ainsi, vous ne serez pas dérangé jusqu'au bout l'expérience utilisateur.

Adressez-vous à votre représentant Google pour répondre à toutes vos questions concernant les informations 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 incluant tout le contenu de votre catalogue, nous vous recommandons de créer un avec un ensemble restreint d'entités. Pendant que vous travaillez sur votre flux, vous risquez de rencontrer les problèmes de sécurité. En limitant la taille de l'ensemble d'entités, vous pourrez déboguer ces erreurs et des avertissements plus facilement.
Valider l'exemple de flux

Nous mettons à votre disposition des outils qui garantissent que votre flux est conforme aux spécifications. Nous vous recommandons à l'aide de ces outils pour résoudre les erreurs et les avertissements détectés dans votre exemple de flux.
Créer un flux de production

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

Créer un exemple de flux

Sélectionnez une entité représentative de votre catalogue. Choisissez une entité dont la structure est relativement complexe, mais qui reste caractéristique d'une entité du catalogue.

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

Outil de validation des flux de données

L'outil de validation des flux de données ne peut valider qu'une seule entité à la fois. Utiliser cet outil pour valider un échantillon de votre catalogue pour détecter les erreurs de structure et les erreurs de contenu courantes. Vous trouverez d'autres consultez cette page pour en savoir plus sur cet outil.
Outil de validation de schéma JSON

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

Créer un flux de production

Une fois que vous avez résolu toutes les erreurs et tous les avertissements de l'exemple de flux, développez le flux afin d'inclure toutes les entités de votre catalogue.
Utiliser l'outil de validation des flux de données pour valider un petit nombre d'entités en même temps. entités sur l'outil peuvent figer le navigateur Web). Vérifier 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 catalogue.

Identifier le prix

Héberger le flux