Sledování zásilek je funkce, která zobrazuje informace týkající se sledování zásilek ve službě Google. Když lidé přijdou do Vyhledávání a budou chtít sledovat balík odeslaný vaší společností, budou moci zadat přímo ID balíku. Funkce použije vaše rozhraní API k načtení informací o sledování balíku a poté je uživateli zobrazí. Zde je uvedeno, jak se mohou informace o sledování balíku zobrazit ve službě Google Search, když uživatel hledá sledování balíku.
Dostupnost funkce
Sledování balíku je k dispozici ve všech jazycích a zemích, kde je k dispozici vyhledávání Google.
Požadavky
Abyste mohli být zařazeni do programu sledování balíků pro první uživatele, musíte splňovat následující požadavky:
- Musíte být doručovací společností nebo jediným oprávněným poskytovatelem informací o sledování balíků pro doručovací společnost.
- Sledování balíků Google provádí volání v reálném čase (pouze požadavky POST) na rozhraní RESTful JSON API za účelem získání informací o sledování balíků. Pokud máte existující rozhraní API, které může tyto informace vracet, můžeme s vámi spolupracovat na jeho opětovném použití. Vaše rozhraní API musí splňovat požadavky na dostupnost a odezvu a poskytovat požadovaný obsah.
Dostupnost a odezva
Od vašeho rozhraní API neočekáváme téměř žádné prostoje a požadujeme, aby vaše rozhraní API reagovalo v průměru do 700 ms, přičemž 95. percentil nesmí překročit 1 000 ms. Pokud vaše API tyto požadavky nesplňuje, můžeme přestat zobrazovat informace o sledování zásilek.
Obsah
Aby integrace fungovala, musí vaše rozhraní API vracet následující informace:
Požadované pole | |
---|---|
CurrentStatus |
Aktuální stav balíku. Zahrnuje datum a čas, kdy se tento stav stal platným, a případné chybové stavy. |
Důrazně doporučujeme, aby rozhraní API vracelo také následující informace:
Doporučená pole | |
---|---|
DeliveredDate |
Den a čas doručení balíčku (pokud byl doručen). |
PromisedDate |
Datum, kdy má být balíček doručen. |
TrackingNumber |
Číslo sledování zásilky. |
TrackingURL |
Adresa URL webové stránky, kterou může uživatel navštívit a zobrazit informace o sledování balíku a případné další podrobnosti. |
SupportPhoneNumbers |
Seznam telefonních čísel podpory dostupných pro jednotlivé regiony. |
TransitEvents |
Soubor událostí, které označují, kdy balík dosáhne prozatímního pokroku na své cestě k příjemci, včetně dne, času, města, státu a země (je-li to relevantní). |
CreateDate |
Den a čas vytvoření sledovacího čísla. |
PickupDate |
Datum převzetí zásilky dopravcem. |
TimestampEvent |
Časové razítko události spojené s daným balíkem. |
LocationEvent |
Místo události spojené s daným balíkem. |
CanReschedule |
Zda lze tento balíček přeplánovat. |
Následující informace nepřijímáme:
- Jakékoli osobní údaje o příjemci nebo odesílateli balíčku.
- Jakékoli zeměpisné údaje o příjemci nebo odesílateli balíčku.
Vyjádřete zájem
Máte zájem o účast v programu sledování zásilek Early Adopters? Vyplňte formulář.