# Migration Guide

## Metadata versus file descriptor

As described in
[Create feeds](https://developers.google.com/actions-center/verticals/events/integration-steps/feeds#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`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `Event.description` | `Service.localized_description` | Check [`LocalizedTextSet`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `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`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| *`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`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `Event.tickets.description` | `Service.ticket_type.localized_option_description` | Check [`LocalizedTextSet`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `Event.tickets.seller_info` | NEW | Check [`LocalizedTextSet`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `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`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `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`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `Event.brand_name` | `Service.ticketing_vertical_specific_data.brand_name` | Check [`LocalizedTextSet`](https://developers.google.com/actions-center/verticals/events/reference/feeds/migration-guide#localized-text-set) |
| `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` |