Stay organized with collections
Save and categorize content based on your preferences.
Implement your feed against our reference documentation. The sandbox environment is available for
you to upload and test your feed at any time.
Create feeds
Generate your feed(s). You transmit most of your inventory data to Google by feeds. To
get started, create your Events JSON feed and a JSON descriptor file.
Descriptor file:
Provide metadata about your feed such as timestamp, feed type and list of files to be
transmitted in the set.
Export your feeds. The feeds format is described with the
protocol buffer 3 syntax, however you can
reference the samples to see the JSON format. We recommend that you upload the feeds in JSON
format.
Upload the feeds to your SFTP server. To upload your feeds, use the
SFTP server information
that Google provided to you and the private key that you created in
Setup. The Google SFTP server is available at sftp://partnerupload.google.com on port
19321.
Upload your files with unique names, such as a name that includes a timestamp. Unique names
help with troubleshooting and allow queries for the feed status.
To determine the size of the feeds and frequency of delivery, use the following guidelines:
Size of feed files and shards:
Keep the feed file size less than 200MB (after compression). Compress them using
gzip
If your file may reach more than 200MB (after compression), split them in multiple
shards following the
Sharding feed files
tutorial. However, this integration alone is unlikely to reach the 200MB limit.
Frequency of complete updates:
A complete event feed is provided at least once a day.
Google evaluates feeds
Once you upload your feeds, Google processes and evaluates them for quality and completeness. We
look at several factors:
[[["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"]],["Last updated 2025-04-09 UTC."],[[["To integrate your event ticketing data with Google, you need to create and upload three feeds: Merchant, Service, and Availability."],["These feeds must be in JSON format, compressed using gzip, and uploaded to Google's SFTP server."],["Each feed has required fields that must be populated correctly for Google to process the data; ensure data accuracy and completeness before uploading."],["Google evaluates submitted feeds based on data quality, completeness, and compliance with specifications to ensure smooth integration."],["You can find detailed information about feed specifications, required fields, and troubleshooting in the provided documentation links within the content."]]],["To integrate, create and upload three feeds: `Merchant` (venue details), `Service` (event details), and `Availability` (event availability). Each feed has required fields; for example, `Merchant` needs `merchant_id`, `name`, and `geo.address`; `Service` requires `service_id`, `merchant_id`, and `localized_service_name`. Upload the JSON-formatted feeds to Google's SFTP server, ensuring files are under 200MB and using unique names. Feeds must include metadata and be delivered completely at least once a day. Google then evaluates them for quality and completeness.\n"]]