Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Programma di monitoraggio della spedizione per primi utenti
La funzionalità Monitoraggio della spedizione mostra informazioni relative al monitoraggio della spedizione su Google. Quando gli utenti usano la Ricerca per monitorare un pacco spedito con la tua azienda, possono inserire direttamente un ID spedizione. La funzionalità usa la tua API per recuperare le informazioni di monitoraggio della spedizione, dopodiché le mostra all'utente. Di seguito viene mostrato come potrebbero essere visualizzate le informazioni di monitoraggio della spedizione sulla Ricerca Google quando un utente vuole monitorare una spedizione.
Disponibilità della funzionalità
Il monitoraggio della spedizione è disponibile in tutte le lingue e in tutti i paesi in cui è disponibile la Ricerca Google.
Requisiti
Per poter partecipare al Programma primi utenti di Monitoraggio della spedizione, devi soddisfare i seguenti requisiti:
La società di spedizioni deve avere sede in India, Giappone o Brasile oppure essere
l'unico fornitore autorizzato a fornire informazioni di monitoraggio delle spedizioni per una società di spedizioni che
opera in queste aree.
La funzionalità di monitoraggio della spedizione di Google effettua chiamate in tempo reale (solo richieste POST) a un'API RESTful JSON per recuperare
le informazioni di monitoraggio della spedizione. Se hai già un'API che può restituire queste informazioni, possiamo collaborare
con te per riutilizzarla. La tua API deve soddisfare il requisito di disponibilità e reattività, nonché fornire i contenuti obbligatori.
Disponibilità e reattività
Ci aspettiamo un tempo di inattività pari quasi a zero per la tua API, che deve inoltre rispondere entro 700 ms (in media) con il 95° percentile che non superi 1000 ms. Se la tua API non soddisfa questi requisiti, potremmo non visualizzare più le tue informazioni di monitoraggio della spedizione.
Contenuti
Affinché l'integrazione funzioni, la tua API deve restituire le seguenti informazioni:
Campo obbligatorio
CurrentStatus
Lo stato corrente della spedizione. Sono inclusi la data e l'ora in cui questo stato è diventato valido ed eventuali stati di errore.
Ti consigliamo vivamente di fare in modo che la tua API restituisca anche le seguenti informazioni:
Campi consigliati
DeliveredDate
Il giorno e l'ora in cui è stato consegnato il pacco (se è stato consegnato).
PromisedDate
La data di consegna prevista del pacco.
TrackingNumber
Il numero di riferimento della spedizione.
TrackingURL
L'URL del sito web che un utente può visitare per visualizzare le informazioni di monitoraggio della spedizione ed eventuali dettagli aggiuntivi.
SupportPhoneNumbers
Un elenco di numeri di telefono per l'assistenza disponibili per area geografica.
TransitEvents
L'insieme di eventi che indicano quando la spedizione fa una tappa intermedia lungo il tragitto per arrivare al destinatario, inclusi giorno, ora, città, stato e paese (se pertinente).
CreateDate
Il giorno e l'ora in cui è stato creato il numero di riferimento.
PickupDate
La data in cui il pacco è stato ritirato dal corriere.
TimestampEvent
Il timestamp di un evento associato a un determinato pacco.
LocationEvent
La posizione di un evento associato a un determinato pacco.
CanReschedule
Se è possibile riprogrammare la consegna del pacco.
Le seguenti informazioni non sono accettate:
Eventuali dati personali relativi al destinatario o al mittente del pacco.
Qualsiasi informazione geografica relativa al destinatario o al mittente del pacco.
Comunicazione di interesse
Se ti interessa partecipare al Programma primi utenti di Monitoraggio della spedizione,
compila il modulo.
[null,null,["Ultimo aggiornamento 2025-08-04 UTC."],[[["\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)."]]
