遷移指南

中繼資料與檔案描述元

如「建立動態饋給」一文所述,檔案描述元必須與動態饋給 JSON 資料檔案一併傳送,且副檔名須為 .filesetdesc.json。這會取代為每個 Merchant/Service/Availability 動態饋給檔案指定的 FeedMetadata

新舊欄位對應

現在所有資料都必須提供至單一 Event 動態饋給。下表列出這個新動態饋給的欄位,以及舊版 Merchant/Service/Availability 動態饋給的欄位對應關係。

新增 注意事項
Event.id Service.service_id
Event.title Service.localized_service_name 檢查 LocalizedTextSet
Event.description Service.localized_description 檢查 LocalizedTextSet
Event.time_info.start_seconds Availability.start_sec
Event.time_info.start_to_be_decided 新功能
Event.time_info.end_seconds Availability.start_sec + Availability.duration_sec
Event.time_info.door_open_seconds 新功能
Event.venue.id Merchant.merchant_id
Event.venue.description 新功能 檢查 LocalizedTextSet
Event.venue.location.place_id Merchant.matching_hints.place_id 如果已設定 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 如果已設定 Event.venue.location.place_info.structured_address,請勿設定
Event.venue.location.business_profile_id 新功能 如果已設定 Event.venue.location.place_info,請勿設定
Event.venue.location.lat_lng.latitude Merchant.geo.latitude 如果已設定 Event.venue.location.place_info,請勿設定
Event.venue.location.lat_lng.longitude Merchant.geo.longitude 如果已設定 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 新功能
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 新功能
Event.related_entities.entity_type Service.ticketing_vertical_specific_data.entity.entity_type ENUM 已變更
Event.related_entities.performer_role Service.ticketing_vertical_specific_data.entity.entity_role ENUM 前置字元已變更
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 檢查 LocalizedTextSet
Event.tickets.description Service.ticket_type.localized_option_description 檢查 LocalizedTextSet
Event.tickets.seller_info 新功能 檢查 LocalizedTextSet
Event.tickets.seller_info.name 新功能
Event.tickets.seller_info.logo_url 新功能
Event.tickets.referral_urls Service.action_link
Event.tickets.referral_urls.link.url Service.action_link.url
Event.tickets.referral_urls.link.mobile_url 新功能
Event.tickets.referral_urls.link.localized_url 新功能 檢查 LocalizedTextSet
Event.tickets.referral_urls.link.localized_mobile_url 新功能
Event.tickets.referral_urls.surface 新功能
Event.tickets.price.value Service.ticket_type.price
Event.tickets.price.is_free 新功能
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 新功能
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 前置字元已變更
Event.related_media.attribution Service.related_media.attribution.localized_text 檢查 LocalizedTextSet
Event.brand_name Service.ticketing_vertical_specific_data.brand_name 檢查 LocalizedTextSet
Event.event_url Service.ticketing_vertical_specific_data.event_url
Event.partner_role 新功能
Event.event_creator.name Service.ticketing_vertical_specific_data.event_creator.name

關於 LocalizedTextSet

LocalizedTextSet 已稍微變更,且與 Text 相比沒有預設值。如要設定預設值,請使用 language_code = "und" 設定 localized_texts

新增
LocalizedTextSet.localized_texts.text (使用 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