تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ميزة "تتبُّع الطرود" في برنامج المستخدمين في مرحلة مبكرة
"تتبُّع الطرود" هي ميزة تعرض المعلومات ذات الصلة بتتبُّع الطرود على Google. عندما يستخدم الأشخاص خدمة "بحث Google" لتتبُّع أحد الطرود التي تشحنها شركتك، سيتمكنون من إدخال رقم تعريف الطرد مباشرةً. وتستخدم هذه الميزة واجهة برمجة التطبيقات لاسترداد معلومات تتبُّع الطرد ثم عرضها للمستخدم. في ما يلي طريقة ظهور معلومات تتبُّع الطرد في "بحث Google" عندما يسعى المستخدم لتتبُّع طرد.
توفّر الميزة
ميزة "تتبُّع الطرود" متوفّرة بجميع اللغات وفي كل البلدان التي يتوفّر فيها محرّك بحث Google.
المتطلبات
لكي تكون مؤهّلاً للمشاركة في برنامج المستخدمين في مرحلة مبكرة لميزة "تتبُّع الطرود"، يجب أن تستوفي المتطلبات التالية:
يجب أن يكون مقرّ شركة تسليم الطرود الخاصة بك خارج الهند أو اليابان أو البرازيل، أو أن تكون المزوِّد الوحيد المعتمَد لمعلومات تتبُّع الطرود في شركة تسليم الطرود التي تقدّم خدمات في تلك المناطق.
تعمل ميزة "تتبُّع الطرود" من Google على توجيه الطلبات في الوقت الفعلي (طلبات POST فقط) إلى RESTful JSON API لعرض معلومات تتبُّع الطرود. إذا كان لديك واجهة برمجة تطبيقات يمكنها عرض هذه المعلومات، يمكننا العمل معك لإعادة استخدامها. يجب أن تلبّي واجهة برمجة التطبيقات متطلبات التوفّر والاستجابة وأن تقدّم المحتوى المطلوب.
التوفّر والاستجابة
نطلب أن تكون فترة التوقف عن العمل شبه معدومة في واجهة برمجة التطبيقات ونشترط أن تستجيب الواجهة خلال 700 ملّي ثانية في المتوسط وألا تتجاوز مدة الاستجابة في 95% من الحالات 1,000 ملّي ثانية. إذا لم تستوفِ واجهة برمجة التطبيقات هذه المتطلبات، قد نتوقف عن عرض معلوماتك المتعلّقة بتتبُّع الطرود.
المحتوى
لكي تنجح عملية الدمج، يجب أن تعرض واجهة برمجة التطبيقات المعلومات التالية:
حقل مطلوب
CurrentStatus
حالة الطرد الحالية، ويتضمّن ذلك تاريخ ووقت بدء سريان الحالة بالإضافة إلى أي حالات خطأ.
نشدّد أيضًا على أهمية أن تعرض واجهة برمجة التطبيقات المعلومات التالية:
الحقول المقترَحة
DeliveredDate
اليوم والوقت الذي تم فيه تسليم الطرد (في حال تسليمه)
PromisedDate
التاريخ المتوقّع لتسليم الطرد
TrackingNumber
رقم تتبُّع الطرد
TrackingURL
عنوان URL للموقع الإلكتروني الذي يمكن للمستخدم زيارته لعرض معلومات تتبُّع الطرد والتفاصيل الإضافية المحتملة
SupportPhoneNumbers
قائمة بأرقام هواتف الدعم المتاحة لكل منطقة
TransitEvents
مجموعة الأحداث التي تبيّن التقدّم المؤقت الذي يحرزه الطرد في مساره إلى المستلِم، ويشمل ذلك بيانات اليوم والوقت والمدينة والولاية والبلد (إن توفّرت)
CreateDate
اليوم والوقت اللذان تم فيهما إنشاء رقم التتبُّع
PickupDate
تاريخ استلام شركة النقل للطرد
TimestampEvent
الطابع الزمني لحدث مرتبط بطرد معيَّن
LocationEvent
الموقع الجغرافي لحدث مرتبط بطرد معيَّن
CanReschedule
ما إذا كان يمكن إعادة جدولة هذا الطرد
لا نقبل المعلومات التالية:
أي بيانات شخصية عن مُستلِم الطرد أو مُرسِله
أي معلومات جغرافية عن مُستلِم الطرد أو مُرسِله
طلب المشاركة
هل تريد المشاركة في برنامج المستخدمين في مرحلة مبكرة لميزة "تتبُّع الطرود"؟
يرجى ملء بيانات النموذج.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle's Package Tracking feature displays real-time package tracking information directly in Google Search results, enhancing the user experience.\u003c/p\u003e\n"],["\u003cp\u003eTo participate in the Early Adopters Program, your package delivery company must primarily serve India, Japan, or Brazil, and have a compatible tracking API.\u003c/p\u003e\n"],["\u003cp\u003eYour tracking API must meet specific availability and responsiveness requirements to ensure a seamless user experience, including a response time within 700ms on average.\u003c/p\u003e\n"],["\u003cp\u003eThe API must provide essential tracking data such as current status, and is recommended to include details like delivery date, transit events, and support contacts, while excluding personal or geographical information about the sender or recipient.\u003c/p\u003e\n"],["\u003cp\u003eInterested parties can express their interest in the program by completing the provided form.\u003c/p\u003e\n"]]],["The Package Tracking Early Adopters Program allows companies to display package tracking information on Google Search. Participants must have a RESTful JSON API that Google can query to retrieve package data via POST requests. The API must be highly available, respond within 700ms on average, and include the `CurrentStatus`. It's recommended to also return fields such as `DeliveredDate`, `PromisedDate`, `TrackingNumber`, and `TransitEvents`. Eligible companies must serve India, Japan, or Brazil. The API cannot return sender or recipient personal data.\n"],null,["# Package Tracking on Google | Google Search Central\n\nPackage tracking Early Adopters Program\n=======================================\n\n\nPackage tracking is a feature that displays package tracking related information on Google. When\npeople come to Search looking to track a package shipped with your company, they'll be able to\nenter a package ID directly. The feature uses your API to retrieve the package tracking\ninformation and then displays it to the user. Here's how package tracking information may appear\non Google Search when a user seeks to track a package.\n| **Note**: The actual appearance in search results might be different.\n\nFeature availability\n--------------------\n\n\nPackage tracking is available in all languages and countries where Google Search is available.\n\nRequirements\n------------\n\n\nTo be considered for participation in the package tracking early adopters program, you must meet\nthe following requirements:\n\n- Your package delivery company must either be based out of India, Japan, or Brazil, or must be the sole authorized provider of packing tracking information for a package delivery company that services those areas.\n- Google Package Tracking makes real-time calls (POST requests only) to a RESTful JSON API to retrieve package tracking information. If you have an existing API that can return this information, we can work with you to re-use it. Your API must meet the [availability and responsiveness requirement](#availability) and provide the [required content](#content).\n\n### Availability and responsiveness\n\n\nWe expect almost no downtime from your API and require that your API respond within 700ms on\naverage with the 95th percentile not exceeding 1,000ms. If your API doesn't meet\nthese requirements, we may stop displaying your package tracking information.\n\n### Content\n\n\nFor the integration to work, your API must return the following information:\n\n| Required field ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------|\n| `CurrentStatus` | The current status of the package. This includes the date and time this status became valid and any error states. |\n\n\nWe strongly recommend that your API also return the following information:\n\n| Recommended fields ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `DeliveredDate` | The day and time the package was delivered (if it has been delivered). |\n| `PromisedDate` | The date the package is expected to be delivered. |\n| `TrackingNumber` | The tracking number for the package. |\n| `TrackingURL` | The website URL that a user can visit to view package tracking information and possible additional details. |\n| `SupportPhoneNumbers` | A list of support phone numbers available per region. |\n| `TransitEvents` | The set of events that denote when a package makes interim progress on its journey to the recipient, including the Day, Time, City, State, and Country (where applicable). |\n| `CreateDate` | The day and time the tracking number was created. |\n| `PickupDate` | The date the package was picked up by the carrier. |\n| `TimestampEvent` | The timestamp of an event associated with a given package. |\n| `LocationEvent` | The location of an event associated with a given package. |\n| `CanReschedule` | Whether this package can be re-scheduled. |\n\n\nWe don't accept the following information:\n\n- Any personal data about the recipient or sender of the package.\n- Any geographical information about the recipient or sender of the package.\n\nExpress interest\n----------------\n\n\nInterested in participating in the Package tracking Early Adopters Program?\n[Fill out the form](https://docs.google.com/forms/d/e/1FAIpQLSeHkDALO5vJg1l4GaUkkBzxeqDtkJukJokBBOtbmlH9Vk9M_w/viewform)."]]
