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

Créer un flux

Le flux multimédia est un objet JSON qui contient une collection d'entités représentant les contenus multimédias de votre catalogue, tels que les séries TV, les films, les titres, les 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 l'extraire régulièrement.

Exigences concernant le format des fichiers de flux

Voici les conditions requises pour le ou 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 en UTF-8 (vérifiez le paramètre de votre éditeur de fichiers).
Si votre fichier de flux est supérieur à 1 Go (non compressé), scindez-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, vous pouvez inclure autant d'entités que vous le souhaitez dans un seul fichier.
Assurez-vous que le fichier est encodé sans BOM, conformément à la spécification JSON. Pour vérifier sur 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 représentent l'ensemble de votre catalogue que vous souhaitez lancer sur Google. Découvrez 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 avec Google pour la première fois.
Une fois ce flux envoyé à Google, il sera analysé et itéré plusieurs fois afin d'atteindre un niveau de qualité plus élevé en termes de quantité d'informations collectées et de 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 de ce type :
- Extension du flux pour inclure de nouveaux types d'entités, qui n'avaient pas été lancés auparavant.
- Élargissement du flux pour inclure un grand nombre de nouvelles entités/métadonnées à lancer dans de nouvelles langues.
- 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 l'étendre à Google TV.
Dans ce cas, un flux de préproduction est nécessaire. Ce flux est une copie du flux de production, mais il contient des métadonnées supplémentaires, par exemple des liens profonds pour une nouvelle plate-forme, des métadonnées pour une nouvelle langue, etc.
Comme pour le flux de production, il sera analysé en profondeur et itéré plusieurs fois afin d'atteindre un niveau de qualité plus élevé en termes de quantité d'informations collectées et de 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, d'effectuer tous les tests requis, sans affecter le flux de production. Cela garantit une expérience utilisateur optimale.

Contactez votre représentant Google pour toute question concernant les points 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 l'intégralité du contenu de votre catalogue, nous vous recommandons de créer un flux d'exemple ne contenant qu'un petit nombre 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 plus facilement ces erreurs et avertissements.
Valider l'exemple de flux

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

Une fois que vous avez vérifié que vous avez une bonne structure pour le petit ensemble de vos entités, 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 raisonnablement complexe, mais qui reste typique d'une entité du catalogue.

Utilisez l'outil de validation des flux de données pour rechercher les erreurs de syntaxe et les propriétés requises 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 Google concernant les données structurées pour les flux multimédias.

Outil de validation des flux de données

L'outil de validation de flux de données ne peut valider qu'une seule entité à la fois. Utilisez cet outil pour vérifier si un échantillon d'entité de votre catalogue contient des erreurs structurelles et des erreurs de contenu courantes. Pour en savoir plus sur cet outil, cliquez ici.
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 lors du développement du flux pour éviter les erreurs structurelles courantes. Pour en savoir plus sur cet outil, cliquez ici.

Créer un flux de production

Une fois toutes les erreurs et avertissements de l'exemple de flux corrigés, développez-le 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 (coller un grand nombre d'entités dans l'outil peut entraîner le blocage du navigateur Web). 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.

Identifier le prix

Héberger le flux