برای لینکهای عمیق، شرکا یک URL پایه مخصوص بلیطفروشی ارائه میدهند (به پیکربندی شریک مراجعه کنید). پارامترهای پرسوجویی که به URL اضافه میکنیم ، از افزونه بلیطفروشی Google Transit با مجموعهای اصلاحشده از پارامترها پیروی میکنند:
| نام فیلد | جزئیات |
|---|---|
from_ticketing_stop_time_id | (قابل تکرار) شناسهی ایستگاهی که مرحله از آن شروع میشود. برای یک زمان توقف خاص، این مقدار |
to_ticketing_stop_time_id | (قابل تکرار) شناسهی نقطهای که در آن پا به پایان میرسد. برای یک زمان توقف خاص، این مقدار |
service_date | (تاریخ، تکرارپذیر) روز سرویس سفر. این فیلد به صورت یک آرایه JSON قالببندی میشود که شامل تاریخ با رشته قالببندی زیر است: |
boarding_time | (ISO 8601، تکرارپذیر) تاریخ و زمان حرکت (departure_time) از زمان توقفی که مرحله از آن شروع میشود. مقدار زمان این فیلد مطابق با استاندارد ISO 8601 و با فرمت رشته زیر است: |
arrival_time | (ISO 8601، تکرارپذیر) تاریخ و زمان رسیدن (arrival_time) زمان توقفی که در آن مرحله پایان مییابد. مقدار زمان این فیلد مطابق با استاندارد ISO 8601 و با فرمت رشته زیر است: |
booking_token | (رشته) فیلد اختیاری که برای افزودن دادههای اضافی استفاده میشود. این مقدار از پاسخ API حمل و نقل مسافرتی شما میآید و به لینک عمیق فروش بلیط اضافه میشود. حداکثر طول جستجوی سفر باید بدون توکن رزرو همچنان کار کند، اما میتوان از آن برای حفظ هماهنگی قیمت بین نتایج جستجوی گوگل و صفحه رزرو همکار استفاده کرد. |
lang | (IETF BCP 47، اختیاری) فیلدی که برای نشان دادن زبان انتخاب شده برای سایت رزرو استفاده میشود. مقدار این فیلد با IETF BCP 47 مطابقت دارد، مثلاً اگر زبان انتخاب شده در دسترس نباشد یا فیلد ارسال نشود، سایت رزرو باید از یک زبان جایگزین استفاده کند. |
cur | (ISO 4217، اختیاری) فیلدی که برای نشان دادن واحد پولی که قیمتها باید با آن نمایش داده شوند، استفاده میشود. مقدار این فیلد مطابق با استاندارد ISO 4217 است، مثلاً اگر ارز انتخاب شده نمایش داده نشود یا فیلد ارسال نشود، سایت رزرو باید از یک ارز جایگزین استفاده کند. |
utm_source | (رشتهای، اختیاری) فیلدی که برای نشان دادن سایت سطح بالایی که ترافیک را ارسال کرده است، استفاده میشود. مقادیر ممکن عبارتند از |
تمام پارامترهای تکرارپذیر به صورت یک آرایه JSON مشخص میشوند که در آن مقادیر چندگانه نشاندهنده توقفهای انتقال هستند. میتوانید نمونههایی از کدگذاری URL را در نمونههای افزونه بلیط حمل و نقل گوگل (Google Transit Ticketing Extension) بیابید.