Panoramica

La struttura del feed di dati di Ordina con Google è definita dallo schema di inventario relazionale. Il feed di dati di Ordina con Google è costituito dalle seguenti entità di primo livello:

Il seguente diagramma mostra in che modo le entità Service, Restaurant e Menu rappresentano un singolo ristorante:

Diagramma relativo alla relazione tra i corsi del servizio di ristorazione
Figura 1: relazione generale delle entità del feed di dati di Ordina con Google: servizio, ristorante e menu.

Linee guida generali

  • Ristoranti per file: ogni file di dati deve rappresentare un ristorante con le relative entità Service e Menu. Usa i nomi dei file che possono aiutarti a cercare un file in un ristorante.

  • Formato file di dati: i file di dati devono essere formattati in file JSON separati da nuova riga (formato json.).

  • Valori DateTime e Time: per le proprietà che richiedono un valore DateTime o Time, utilizza i formati specificati in formati DateTime e Time. Ad esempio, 2017-05-01T06:30:00+05:30 per DateTime e T08:08:00+05:30 per Time.

  • ID: utilizza una proprietà @id per identificare tutte le entità univoche all'interno di un tipo di entità. La lunghezza massima è di 300 caratteri. @id è un identificatore univoco dell'entità di quel tipo, ma tra le entità possono essere sovrapposti gli ID. Ad esempio, supponi di definire un'entità Service con la proprietà @id impostata su a16. Impossibile creare un'altra entità Service con @id: a16. Tuttavia, puoi utilizzare a16 come valore @id di un'entità Menu.

  • Generazione ID: mantieni gli ID stabili, non utilizzare gli UUID o altrimenti cambia/in modo casuale gli ID tra un caricamento e l'altro. Ciò consente di facilitare il supporto per problemi relativi alle entità.

  • Valori null: non utilizzare il valore null al posto degli oggetti. Se un oggetto è facoltativo, devi ometterlo dal feed.

Librerie client

Il generatore di codice client nella sezione Strumenti è disponibile per convalidare il feed di dati di Ordina con Google.