使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
“包裹跟踪”功能尝鲜者计划
“包裹跟踪”是一项在 Google 上显示包裹跟踪相关信息的功能。借助此功能,当用户想要通过 Google 搜索跟踪由贵公司运输的包裹时,只需直接输入包裹编号即可。该功能会使用您的 API 检索包裹跟踪信息,然后将其显示给用户。下方展示了当用户试图跟踪某个包裹时,他们可能会在 Google 搜索上看到的包裹跟踪信息画面。
功能可用性
“包裹跟踪”功能适用于 Google 搜索支持的所有语言及国家/地区。
要求
如需申请加入“包裹跟踪”功能尝鲜者计划,您必须满足以下要求:
-
您的包裹配送公司必须位于印度、日本或巴西境外,或者是服务于这些地区的某家包裹配送公司的唯一包裹跟踪信息授权提供方。
-
Google“包裹跟踪”功能会实时调用 RESTful JSON API(仅限 POST 请求),以检索包裹跟踪信息。如果您已经有可以返回此类信息的 API,我们可以帮助您重复利用该 API。您的 API 必须符合可用性和响应性要求,并提供必要内容。
可用性和响应性
我们希望您的 API 几乎不会停机,并要求 API 的平均响应时间不超过 700 毫秒,95% 以上的响应不超过 1,000 毫秒。如果您的 API 不符合上述要求,我们可能会停止显示您的包裹跟踪信息。
内容
为了使集成功能正常运行,您的 API 必须返回以下信息:
必需字段 |
CurrentStatus
|
包裹的当前状态。这包括此状态生效的日期和时间,以及任何错误状态。
|
此外,我们强烈建议您让 API 返回以下信息:
建议字段 |
DeliveredDate
|
包裹的送达日期和时间(如果包裹已送达)。
|
PromisedDate
|
包裹的预计送达日期。
|
TrackingNumber
|
包裹的跟踪编号。
|
TrackingURL
|
用户可以在上面查看包裹跟踪信息和其他潜在详情的网站网址。
|
SupportPhoneNumbers
|
按地区列出可用的支持电话号码。
|
TransitEvents
|
表示包裹在送达收件人前的阶段性变动,包括日期、时间、城市、州和国家/地区(如果适用)。
|
CreateDate
|
跟踪编号的创建日期和时间。
|
PickupDate
|
运输公司揽收包裹的日期。
|
TimestampEvent
|
与指定包裹相关联的事件的时间戳。
|
LocationEvent
|
与指定包裹相关联的事件的地点。
|
CanReschedule
|
是否可以重新安排此包裹的运送时间。
|
我们不接受以下信息:
- 包裹收件人或发件人的任何个人数据。
- 包裹收件人或发件人的任何地理位置信息。
填写申请表单
想要加入“包裹跟踪”功能尝鲜者计划?请填写此表单。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-04。
[null,null,["最后更新时间 (UTC):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)."]]