Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une fois votre fichier de flux prêt, hébergez-le à un emplacement sécurisé. Google explore régulièrement le flux, généralement une fois par jour, pour s'assurer que votre contenu reste à jour. Contactez votre représentant Google pour lui communiquer les informations d'hébergement et le meilleur moment pour récupérer le flux à partir de votre emplacement hébergé.
Recommandations pour héberger le flux
Bien que le fournisseur de données soit libre de déterminer la meilleure façon d'héberger le flux et la façon dont il est structuré à l'emplacement hébergé, voici quelques recommandations sur la façon dont le flux doit être structuré pour permettre une récupération fluide.
Créez un dossier nommé "latest" (sans distinction entre majuscules et minuscules). Assurez-vous que ce dossier est mis à jour quotidiennement avec les fichiers de flux JSON et qu'il ne contient que les fichiers que Google doit extraire pour la journée à un moment donné.
Ne créez pas de sous-dossiers dans le dernier dossier. Conservez une hiérarchie plate, c'est-à-dire que tous les fichiers JSON doivent se trouver directement sous le dossier "latest".
Vous pouvez également choisir de stocker au moins le flux des 30 derniers jours dans des dossiers nommés "date-heure". Cela peut s'avérer utile si vous devez identifier un problème avec la version précédente du flux ou rechercher des métadonnées précédemment fournies. Google n'utilisera pas ces dossiers de quelque manière que ce soit.
Assurez-vous que le dossier "latest" ne contient à aucun moment de fichiers de 0 Ko ou vides.
Assurez-vous que Google a toujours accès au dossier "latest" afin que les fichiers puissent être récupérés de manière fluide.
Si Google demande un flux de préproduction, assurez-vous de créer un dossier distinct pour l'héberger. Par exemple, si la hiérarchie du flux de production est ../latest/, vous pouvez créer une hiérarchie différente pour le flux de préproduction, par exemple ../staging/latest/.
Méthodes d'hébergement
Le tableau ci-dessous liste les méthodes d'hébergement de flux acceptées et les informations à partager avec les représentants Google.
Méthode
Informations requises
Authentification acceptée
Google Cloud Storage (GCS)
URL de l'objet, du bucket ou du dossier GCS
Identifiants d'accès
Meilleur moment pour extraire le flux une fois par jour
Les URL Google Cloud Storage doivent être partagées avec "088794101-100000002-account@partnercontent.gserviceaccount.com" (autorisation de lecteur des objets de l'espace de stockage) Pour en savoir plus, consultez la section
Héberger le flux sur Google Cloud Storage.
HTTPS
URL du ou des serveurs HTTP
Identifiants d'accès
Meilleur moment pour extraire le flux une fois par jour
Meilleur moment pour extraire le flux une fois par jour
Nom d'utilisateur et mot de passe, ou
Nom d'utilisateur, clé privée et phrase secrète de la clé privée ou
Combinaison des deux options ci-dessus
AWS S3
URL des buckets S3 (exemple: S3://mediafeed-bucket/latest)
Région du bucket S3 (par exemple, EU-WEST-1)
Identifiants d'accès
Meilleur moment pour extraire le flux une fois par jour
L'ID de clé d'accès et la clé d'accès secrète ou
Buckets S3 avec accès non restreint (non recommandé)
Une fois que vous avez importé vos fichiers de flux à l'aide de l'une des méthodes ci-dessus, contactez l'équipe Media Actions pour qu'elle les examine.
Héberger le flux sur Google Cloud Storage
Les étapes suivantes montrent comment importer un fichier de flux dans Google Cloud Storage:
Connectez-vous à la console Google Cloud Platform, puis cliquez sur le menu déroulant Select a project (Sélectionner un projet).
Dans la fenêtre pop-up, cliquez sur NEW PROJECT (NOUVEAU PROJET).
Attribuez un nom à votre projet, puis cliquez sur CRÉER.
Dans le menu de navigation, cliquez sur Storage > Browser (Stockage > Navigateur).
Si vous n'êtes pas encore inscrit à Google Cloud Storage, cliquez sur S'inscrire à un essai sans frais pour commencer votre essai sans frais. (Vous ne payez ce service qu'après avoir atteint votre seuil de facturation ou au bout de 30 jours.)
Après vous être inscrit à un essai sans frais, actualisez le navigateur pour mettre à jour l'écran.
Cliquez sur Créer un bucket.
Nommez votre bucket, puis cliquez sur Créer.
Sur la page "Informations sur le bucket", cliquez sur Importer des fichiers.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
[null,null,[],[[["\u003cp\u003eGoogle will fetch your content feed daily, or more frequently for live content, to keep your information current.\u003c/p\u003e\n"],["\u003cp\u003eStructure your feed with a "latest" folder containing daily JSON files for seamless fetching by Google.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally archive past feeds in dated folders for your own tracking purposes.\u003c/p\u003e\n"],["\u003cp\u003eChoose a hosting method from Google Cloud Storage, HTTPS, SFTP, or AWS S3, and share the details with your Google representative.\u003c/p\u003e\n"],["\u003cp\u003eWhen using Google Cloud Storage, ensure the "Storage Object Viewer" permission is granted to the designated Google account for access.\u003c/p\u003e\n"]]],["Host the feed at a secure location for Google to fetch regularly, typically once daily. Structure the feed with a \"latest\" folder containing current JSON feed files, and optionally, \"date-time\" folders for the last 30 days. Supported hosting methods include Google Cloud Storage, HTTPS, SFTP, and AWS S3, each requiring specific details and credentials shared with Google. For Google Cloud Storage, share the bucket URL and grant Storage Object Viewer permission to `088794101-100000002-account@partnercontent.gserviceaccount.com`. Then contact the Media Actions team to review the feed.\n"],null,["# Host the feed file\n\nOnce your feed file is ready, host it at a secure location. Google fetches the feed regularly, typically\nonce a day, to ensure that your content stays up-to-date. Work with your Google representative to\nshare the hosting details and the best time to fetch the feed from your hosted location.\n| **Note:** For certain use cases that require more real time data ingestion, such as Live TV use case where the programing can often update multiple times a day, Google may decide to fetch the feed more than once a day. In such cases, a representative may contact you to determine the best possible times to fetch the feed from your hosted location.\n\nRecommendations for hosting the feed\n------------------------------------\n\nAlthough it's at the discretion of the data provider to determine the best way to host the feed and\nhow the feed is structured at the hosted location, here are some recommendations on how the feed\nshould be structured to enable a seamless fetch.\n\n- Create a folder named \"latest\" (case insensitive). Make sure this folder is updated with the JSON feed files daily and only contains the files that Google should fetch for the day at any given time.\n- Do not create any subfolders under the latest folder. Keep the hierarchy flat i.e. all the json files should be present directly under the \"latest\" folder.\n- Optionally, you can choose to store at least the last 30 days feed in folders named \"date-time\". This can come in handy in case there's a need to track down an issue with the previous version of the feed or lookup previously provided metadata. Google will not use these folders in any way.\n- Make sure the \"latest\" folder does not have any files with 0KB size/empty files at any given time.\n- Make sure that Google always has access to the \"latest\" folder so the files can be fetched in a seamless manner.\n- In case Google requests for a staging feed, make sure a separate folder is created to host the staging feed. For example, if the hierarchy for the production feed is ../latest/, then you can create a different hierarchy for the staging feed, for example, ../staging/latest/.\n\nHosting methods\n---------------\n\nThe table below lists the supported feed hosting methods and the details required to be shared with\nGoogle representatives.\n\n|----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Method** | **Details Required** | **Authentication Support** |\n| Google Cloud Storage (GCS) | - GCS object, bucket or folder URL(s) - Access Credentials - Best time to fetch the feed once daily | - Google Cloud Storage URLs must be shared with \\`088794101-100000002-account@partnercontent.gserviceaccount.com\\` (Storage Object Viewer permission) See more details in [Host the feed on Google Cloud Storage](#host_the_feed_on_google_cloud_storage) section |\n| HTTPS | - HTTP Server URL(s) - Access Credentials - Best time to fetch the feed once daily | - Username **and** Password **or** [HTTP client certificates](https://support.google.com/webmasters/answer/6073543) |\n| SFTP | - SFTP Server URL(s) - Access Credentials - Best time to fetch the feed once daily | - Username **and** Password, **or** - Username, Private Key, **and** Private Key Passphrase **or** - Combination of both of the above |\n| AWS S3 | - S3 Bucket URL(s) (Example: S3://mediafeed-bucket/latest) - S3 Bucket Region (Example: EU-WEST-1) - Access Credentials - Best time to fetch the feed once daily | - Both Access Key ID **and** Secret Access Key **or** - S3 Buckets with unrestricted access (not preferred) |\n\nAfter you upload your feed file(s) using one of the above methods, contact the Media Actions team\nto review your feed file(s).\n\nHost the feed on Google Cloud Storage\n-------------------------------------\n\nThe following steps demonstrates how to upload a feed file on Google Cloud Storage:\n\n1. Log in to [Google Cloud Platform console](https://console.cloud.google.com)\n and click the **Select a project** dropdown menu.\n\n2. In the pop-up window, click **NEW PROJECT**.\n\n3. Name your new project and click **CREATE**.\n\n4. On the navigation menu, click **Storage \\\u003e Browser**.\n\n5. If you haven't already signed up for Google Cloud Storage, click **Sign up for a free trial** to start your free trial. (You pay for this service only after you reach your billing threshold or 30 days have passed.)\n\n6. After signing up for a free trial, refresh the browser to update the screen.\n\n7. Click **Create bucket**.\n\n8. Name your bucket and click **Create**.\n\n9. On the Bucket details page, click **Upload files**.\n\n10. Upload your [feed file](./create-a-feed).\n\n | **Note:** Media Actions expect the feed to be updated regularly. To learn how to programmatically upload files to your Cloud Storage bucket, see this [page](https://cloud.google.com/storage/docs/uploading-objects).\n11. On the Bucket details page, click **Permissions**.\n\n12. Click **Add members**.\n\n13. In the **New members** field, enter the following email address:\n\n 088794101-100000002-account@partnercontent.gserviceaccount.com\n\n14. In the dropdown, select **Storage Object Viewer** and click **Save**.\n\nAfter you upload your feed file to a host system, contact the Media Actions team to review your feed file."]]
