Stay organized with collections
Save and categorize content based on your preferences.
Once your feed file is ready, host it at a secure location. Google fetches the feed regularly, typically
once a day, to ensure that your content stays up-to-date. Work with your Google representative to
share the hosting details and the best time to fetch the feed from your hosted location.
Recommendations for hosting the feed
Although it's at the discretion of the data provider to determine the best way to host the feed and
how the feed is structured at the hosted location, here are some recommendations on how the feed
should be structured to enable a seamless fetch.
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.
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.
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.
Make sure the “latest” folder does not have any files with 0KB size/empty files at any given time.
Make sure that Google always has access to the “latest” folder so the files can be fetched in a
seamless manner.
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/.
Hosting methods
The table below lists the supported feed hosting methods and the details required to be shared with
Google representatives.
Method
Details Required
Authentication Support
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 section
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.)
After signing up for a free trial, refresh the browser to update the screen.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["Google will fetch your content feed daily, or more frequently for live content, to keep your information current."],["Structure your feed with a \"latest\" folder containing daily JSON files for seamless fetching by Google."],["You can optionally archive past feeds in dated folders for your own tracking purposes."],["Choose a hosting method from Google Cloud Storage, HTTPS, SFTP, or AWS S3, and share the details with your Google representative."],["When using Google Cloud Storage, ensure the \"Storage Object Viewer\" permission is granted to the designated Google account for access."]]],["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"]]
