Configurazione account

Ordina con Google richiede un account attivo sul portale partner. Il portale ti consente di accedere agli strumenti per il caricamento dei feed di dati e alla configurazione degli endpoint dei servizi web. La creazione dell'account verrà avviata dal team di Ordina con Google dopo la firma del contratto.

Creazione dell'account iniziale

Una volta creato l'account, viene inviata un'email di conferma all'indirizzo associato al tuo contatto aziendale Google. L'email contiene i link al tuo account sul portale e alla guida alle operazioni preliminari.

Per completare la creazione iniziale dell'account:

1. Fai clic sul link al tuo account fornito nell'email di conferma. Alla prima visita del portale partner ti verrà chiesto di aggiungere i dati di contatto di emergenza, nel caso in cui tu non ne abbia già bisogno. Segui questa guida per inserire i tuoi dati di contatto. Puoi aggiornare i dati di contatto in un secondo momento nella pagina Account e utenti > Dati di contatto.

   

2. Vai alla pagina Account e utenti nel portale. Nella scheda Utenti puoi concedere l'accesso ai membri del tuo team aggiungendo i loro account all'elenco degli utenti. Per ulteriori dettagli, consulta l'articolo Account e utenti.

Una volta completata la creazione iniziale dell'account, il tuo team potrà utilizzare il portale partner come strumento principale per gestire l'integrazione di Ordina con Google. Per ulteriori dettagli, segui i passaggi elencati nella pagina Attività di onboarding.

Gestione dei brand

Su Ordina con Google un brand è costituito da una raccolta di localizzazioni. Ogni localizzazione ha un nome del brand, un logo, norme sulla privacy, termini di servizio, paese e lingua target. In questo modo, potete specificare il branding localizzato a livello di paese e lingua. I brand sono configurati separatamente nella sandbox e nella produzione. Dovrai configurare un brand con almeno una località per ogni paese in cui hai ristoranti, altrimenti i tuoi ristoranti non verranno visualizzati su Google o non saranno testabili dal portale partner. Visita la pagina Gestione dei brand per istruzioni dettagliate su come localizzare i tuoi brand.

Attività di onboarding

Nella pagina Attività di onboarding sono elencati i passaggi per iniziare e fornire la configurazione iniziale dell'account. Completale per assicurarti che il tuo account sia completamente funzionante.

Configura progetto Google Cloud

Per gestire l'integrazione con le API di Ordina con Google, è necessario un progetto Google Cloud. Puoi creare un nuovo progetto o utilizzarne uno esistente a questo scopo. Ti consigliamo di creare un nuovo progetto, perché Google deve potervi accedere.

Dopo aver creato il progetto, devi disporre del numero del progetto cloud e dell'indirizzo email del progetto cloud per continuare con le attività di onboarding:

• Il numero del progetto cloud è disponibile nella console di GCP. Vai a Home > Dashboard > Informazioni sul progetto.
• L'indirizzo email del progetto cloud è indicato in IAM e amministrazione > IAM > Autorizzazioni. Devi disporre dell'indirizzo email che ha il ruolo Proprietario.

Aggiungi e salva il numero di progetto e l'indirizzo email nel modulo Partner Portal > Attività di onboarding > Configurazione del progetto Cloud.

Nota: una volta impostati i dettagli del progetto in Configurazione progetto Cloud, non puoi modificarli sul portale. Se devi apportare modifiche, contatta il tuo specialista di onboarding di Google in modo che possiamo apportare le modifiche da parte nostra.

Configura l'origine del feed di dati

Devi ospitare i file del feed di dati nella tua infrastruttura. Ordina con Google supporta tre tipi di soluzioni di hosting di file: Google Cloud Storage, Amazon S3 e un host web con una Sitemap che gestisce i file tramite HTTPS. Ulteriori requisiti sull'origine del feed di dati sono disponibili nella nostra pagina Prerequisiti. A questo punto, continua con i passaggi nelle sezioni seguenti per il tipo di origine di feed di dati.

Configurazione iniziale dell'origine del feed di dati su Google Cloud Storage

1. Apri la scheda Attività di onboarding nel Portale partner.
2. Vai al passaggio Scegli l'origine del feed.
3. Compila il modulo Fonte del feed:
   1. Metodo di recapito dei feed: scegli Google Cloud Storage.
   2. File indicatore: fornisci l'URL del file marker.txt.
   3. File di dati: fornisci l'URL al bucket GCS contenente i feed di dati.
4. Fai clic su Invia.

Nota: quando utilizzi Google Cloud Storage, devi concedere l'accesso in lettura al bucket GCS per un account di servizio speciale. Puoi trovarlo in Configurazione > Feed dopo aver completato le attività di onboarding. Questo account di servizio richiede il ruolo "Lettore oggetti legacy Storage". Questo ruolo può essere concesso all'account di servizio nella pagina IAM della console Google Cloud.

Configurazione iniziale dell'origine del feed di dati su Amazon S3

1. Apri la scheda Attività di onboarding nel Portale partner.
2. Vai al passaggio Scegli l'origine del feed.
3. Compila il modulo Fonte del feed:
   1. Metodo di recapito dei feed: scegli Amazon S3.
   2. File Marker: fornisci l'URL del file marker.txt.
   3. File di dati: fornisci l'URL al bucket S3 contenente i feed di dati.
   4. Access ID (ID accesso): inserisci l'ID chiave di accesso IAM con autorizzazioni per leggere dalle risorse S3.
   5. Access Key (Chiave di accesso): inserisci la chiave di accesso segreta IAM con le autorizzazioni di lettura dalle risorse S3.
4. Fai clic su Invia.

Configurazione iniziale dell'origine del feed di dati su HTTPS con Sitemap

1. Apri la scheda Attività di onboarding nel Portale partner.
2. Vai al passaggio Scegli l'origine del feed.
3. Compila il modulo Fonte del feed:
   1. Metodo di pubblicazione dei feed: scegli HTTPS.
   2. File Sitemap: indica l'URL del file sitemap.xml.
   3. Nome utente: inserisci le credenziali del nome utente per accedere al server HTTPS.
   4. Password: inserisci la password per accedere al server HTTPS.
4. Fai clic su Invia.

Una volta completata la configurazione dell'account, potrai modificare le impostazioni dell'origine del feed di dati nella pagina Configurazione > Feed.

Configurare un account di servizio

È necessario un account di servizio per effettuare richieste HTTPS autenticate alle API di Google, ad esempio l'API degli aggiornamenti in tempo reale e l'aggiornamento dell'ordine asincrono.

Per configurare un account di servizio:

1. Accedere alla console di Google Cloud Platform.
2. Al tuo account sul portale partner è associato anche un progetto Google Cloud. Seleziona il progetto, se non è già selezionato.
3. Fai clic su Account di servizio nel menu a sinistra.
4. Fai clic su Crea account di servizio.
5. Inserisci un nome per l'account di servizio e fai clic su Create (Crea).
6. In Seleziona un ruolo, scegli Progetto > Editor.
7. Fai clic su Continua.
8. (Facoltativo) Aggiungi gli utenti per concedere loro l'accesso all'account di servizio e fai clic su Fine.
9. Fai clic su > Crea chiave per l'account di servizio appena creato.
10. Seleziona JSON come formato e fai clic su Crea.
11. Dopo aver generato la nuova coppia di chiavi pubblica/privata, scaricala sulla tua macchina.

Attenzione: non puoi recuperare la coppia di chiavi private dalla console Google Cloud. Sei responsabile dell'archiviazione in sicurezza. In caso di smarrimento della chiave, è possibile crearne una nuova.

Aggiungi un URL di evasione degli ordini

Per testare l'integrazione, devi configurare l'URL dell'API di fulfillment. L'URL di evasione degli ordini associa l'account Portale partner all'endpoint dell'URL del servizio web, che ospita il servizio web implementato seguendo lo schema di evasione degli ordini.

Per configurare l'URL di evasione degli ordini, procedi nel seguente modo:

1. Sul portale partner, vai a Configurazione > Endpoint.
2. Aggiungi un URL di evasione dei segnaposto nel campo di testo nella scheda Ordina con Google. In questa fase, l'URL di evasione non deve essere necessariamente un URL funzionante.
3. Fai clic su Salva modifiche.