Migration Guide

Metadata versus file descriptor

As described in Create feeds, a file descriptor with the exact extension .filesetdesc.json, must be sent alongside the feed JSON data files. This replaces the FeedMetadata that was specified for each Merchant/Service/Availability feed file.

Mapping between new and old fields

All the data must be now provided into a single Event feed. Here is the mapping between the field from this new feed and the fields from the legacy Merchant/Service/Availability feeds.

New	Old	Note
Event.id	Service.service_id
Event.title	Service.localized_service_name	Check LocalizedTextSet
Event.description	Service.localized_description	Check LocalizedTextSet
Event.time_info.start_seconds	Availability.start_sec
Event.time_info.start_to_be_decided	NEW
Event.time_info.end_seconds	Availability.start_sec + Availability.duration_sec
Event.time_info.door_open_seconds	NEW
Event.venue.id	Merchant.merchant_id
Event.venue.description	NEW	Check LocalizedTextSet
Event.venue.location.place_id	Merchant.matching_hints.place_id	DO NOT SET if you set Event.venue.location.place_info
Event.venue.location.place_info.name	Merchant.name
Event.venue.location.place_info.phone_number	Merchant.telephone
Event.venue.location.place_info.website_url	Merchant.url
Event.venue.location.place_info.coordinates.latitude	Merchant.geo.latitude
Event.venue.location.place_info.coordinates.longitude	Merchant.geo.longitude
Event.venue.location.place_info.structured_address.street_address	Merchant.geo.street_address
Event.venue.location.place_info.structured_address.locality	Merchant.geo.locality
Event.venue.location.place_info.structured_address.administrative_area	Merchant.geo.admin_area
Event.venue.location.place_info.structured_address.postal_code	Merchant.geo.postal_code
Event.venue.location.place_info.structured_address.country_code	Merchant.geo.country_code
Event.venue.location.place_info.unstructured_address	Merchant.geo.unstructured_address	DO NOT SET if you set Event.venue.location.place_info.structured_address
Event.venue.location.business_profile_id	NEW	DO NOT SET if you set Event.venue.location.place_info
Event.venue.location.lat_lng.latitude	Merchant.geo.latitude	DO NOT SET if you set Event.venue.location.place_info
Event.venue.location.lat_lng.longitude	Merchant.geo.longitude	DO NOT SET if you set Event.venue.location.place_info
Event.related_entities.id	Service.ticketing_vertical_specific_data.entity.id
Event.related_entities.name	Service.ticketing_vertical_specific_data.entity.name
Event.related_entities.official_website_url	NEW
Event.related_entities.url	Service.ticketing_vertical_specific_data.entity.url
Event.related_entities.related_urls	Service.ticketing_vertical_specific_data.entity.public_identification_data.relevant_url
Event.related_entities.musicbrainz_id	Service.ticketing_vertical_specific_data.entity.public_identification_data.musicbrainz_id
Event.related_entities.youtube_channel_id	NEW
Event.related_entities.entity_type	Service.ticketing_vertical_specific_data.entity.entity_type	ENUM has changed
Event.related_entities.performer_role	Service.ticketing_vertical_specific_data.entity.entity_role	ENUM prefix has changed
Event.event_types	Service.ticketing_vertical_specific_data.event_category
Event.tickets.id	Service.ticket_type.ticket_type_id
Event.tickets.title	Service.ticket_type.localized_short_description	Check LocalizedTextSet
Event.tickets.description	Service.ticket_type.localized_option_description	Check LocalizedTextSet
Event.tickets.seller_info	NEW	Check LocalizedTextSet
Event.tickets.seller_info.name	NEW
Event.tickets.seller_info.logo_url	NEW
Event.tickets.referral_urls	Service.action_link
Event.tickets.referral_urls.link.url	Service.action_link.url
Event.tickets.referral_urls.link.mobile_url	NEW
Event.tickets.referral_urls.link.localized_url	NEW	Check LocalizedTextSet
Event.tickets.referral_urls.link.localized_mobile_url	NEW
Event.tickets.referral_urls.surface	NEW
Event.tickets.price.value	Service.ticket_type.price
Event.tickets.price.is_free	NEW
Event.tickets.price.per_ticket_fee	Service.per_order_fee.fee_amount
Event.tickets.price.per_ticket_tax	Service.tax_rate
Event.tickets.price.price_display_type	Service.ticket_type.price_display_type
Event.tickets.availability_info.onsale_start_seconds	Availability.scheduling_rule_overrides.first_bookable_sec
Event.tickets.availability_info.onsale_end_seconds	Availability.scheduling_rule_overrides.last_bookable_sec
Event.tickets.availability_info.spots_total	Availability.spots_total
Event.tickets.availability_info.spots_available	Availability.spots_open
Event.tickets.cancellation_policy	Service.rules.cancellation_policy
Event.tickets.cancellation_policy.refund_conditions.min_duration_before_start_time_sec	Service.rules.cancellation_policy.min_duration_before_start_time_sec
Event.tickets.cancellation_policy.refund_conditions.refund_percent	Service.rules.cancellation_policy.refund_percent
Event.tickets.cancellation_policy.refund_conditions.refund_fee	NEW
Event.tickets.inventory_type	Service.ticket_type.inventory_type
Event.related_media.url	Service.related_media.url
Event.related_media.type	Service.related_media.type	ENUM prefix has changed
Event.related_media.attribution	Service.related_media.attribution.localized_text	Check LocalizedTextSet
Event.brand_name	Service.ticketing_vertical_specific_data.brand_name	Check LocalizedTextSet
Event.event_url	Service.ticketing_vertical_specific_data.event_url
Event.partner_role	NEW
Event.event_creator.name	Service.ticketing_vertical_specific_data.event_creator.name

About LocalizedTextSet

LocalizedTextSet has been slightly changed and does not have a default value compared to Text. To set a default value, set a localized_texts with language_code = "und".

New	Old
LocalizedTextSet.localized_texts.text with LocalizedTextSet.localized_texts.language_code = "und"	Text.value
LocalizedTextSet.localized_texts.text	Text.localized_value.value
LocalizedTextSet.localized_texts.language_code	Text.localized_value.locale