Order with Google nécessite que vous disposiez d'un compte actif sur le portail des partenaires. Le portail vous donne accès à des outils d'importation de flux de données et à la configuration du point de terminaison du service Web. Une fois votre contrat signé, l'équipe Order with Google lancera la configuration du compte.
Configuration initiale du compte
Une fois votre compte créé, un e-mail de confirmation est envoyé à l'adresse e-mail associée à votre contact commercial Google. Il contient des liens vers votre compte sur le portail et vers le guide d'intégration.
Pour terminer la configuration initiale du compte, procédez comme suit:
Cliquez sur le lien vers votre compte fourni dans l'e-mail de confirmation. Lors de votre première visite sur le portail des partenaires, vous êtes invité à ajouter vos coordonnées d'urgence, au cas où vous n'en auriez pas déjà. Suivez ce guide pour renseigner vos coordonnées. Vous pourrez les modifier ultérieurement sur la page Compte et utilisateurs > Coordonnées.
Accédez à la page Account and Users (Compte et utilisateurs) du portail. Dans l'onglet Utilisateurs, vous pouvez accorder l'accès aux membres de votre équipe en ajoutant leurs comptes à la liste des utilisateurs. Pour en savoir plus, consultez l'article Compte et utilisateurs.
Une fois la configuration initiale de votre compte terminée, votre équipe peut utiliser le portail des partenaires comme outil principal pour gérer l'intégration de Order with Google. Pour en savoir plus, suivez la procédure indiquée sur la page Tâches d'intégration.
Gérer les marques
Sur Order with Google, une marque se compose d'un ensemble de versions localisées. Chaque langue est associée à un nom de marque, un logo, des règles de confidentialité, des conditions d'utilisation, des pays et des langues cibles. Cela vous permet de spécifier le branding localisé au niveau du pays et de la langue. Les marques sont configurées séparément dans le bac à sable et la production. Vous devez configurer une marque avec au moins une localisation pour chaque pays dans lequel vous avez des restaurants. Sinon, vos restaurants n'apparaîtront pas sur Google ni ne pourront être testés sur le portail des partenaires. Pour obtenir des instructions détaillées sur la localisation de vos marques, consultez la page Gérer les marques.
Tâches d'intégration
La page Tâches d'intégration répertorie les étapes à suivre pour vous lancer et fournir la configuration initiale de votre compte. Complétez-les pour vous assurer que votre compte est entièrement fonctionnel.
Configurer un projet Google Cloud
Pour gérer l'intégration avec les API Order with Google, vous devez disposer d'un projet Google Cloud. Vous pouvez créer un projet ou utiliser un projet existant à cette fin. Nous vous recommandons de créer un projet, car Google doit y avoir accès.
Une fois le projet créé, vous avez besoin du numéro et de l'adresse e-mail du projet Cloud pour poursuivre les tâches d'intégration:
- Le numéro de projet Cloud se trouve dans la console GCP. Accédez à Home > Dashboard > Project info (Accueil > Tableau de bord > Informations sur le projet).
- L'adresse e-mail du projet Cloud est répertoriée sous IAM et administration > IAM > Autorisations.Vous avez besoin de l'adresse e-mail qui dispose du rôle Propriétaire.
Ajoutez et enregistrez le numéro de projet et l'adresse e-mail dans le formulaire Portail des partenaires > Tâches d'intégration > Configuration du projet Cloud.
Configurer la source du flux de données
Vous devez héberger les fichiers de flux de données sur votre infrastructure. Order with Google est compatible avec trois types de solutions d'hébergement de fichiers: Google Cloud Storage, Amazon S3 et un hébergeur Web avec un sitemap qui diffuse les fichiers via HTTPS. Des exigences supplémentaires concernant la source du flux de données sont disponibles sur la page Conditions préalables. Passez ensuite aux étapes des sections suivantes pour votre type de source de flux de données.
Configuration initiale de la source de flux de données sur Google Cloud Storage
- Ouvrez l'onglet Tâches d'intégration sur le portail des partenaires.
- Accédez à l'étape Sélectionner une source de flux.
- Remplissez le formulaire correspondant à la source du flux :
- Feed delivery method (Mode d'envoi du flux) : sélectionnez Google Cloud Storage.
- Fichier de repère : indiquez l'URL du fichier
marker.txt
. - Fichiers de données : indiquez l'URL du bucket GCS contenant les flux de données.
- Cliquez sur Envoyer.
Configuration initiale de la source de flux de données sur Amazon S3
- Ouvrez l'onglet Tâches d'intégration sur le portail des partenaires.
- Accédez à l'étape Sélectionner une source de flux.
- Remplissez le formulaire correspondant à la source du flux :
- Feed delivery method (Mode d'envoi du flux) : sélectionnez Amazon S3.
- Fichier de repère: indiquez l'URL du fichier
marker.txt
. - Fichiers de données: indiquez l'URL du bucket S3 contenant les flux de données.
- ID d'accès: saisissez l'ID de clé d'accès IAM avec les autorisations permettant de lire les ressources S3.
- Access Key (Clé d'accès) : saisissez la clé d'accès secrète IAM avec les autorisations nécessaires pour lire les données des ressources S3.
- Cliquez sur Envoyer.
Configuration initiale de la source de flux de données sur HTTPS avec un sitemap
- Ouvrez l'onglet Tâches d'intégration sur le portail des partenaires.
- Accédez à l'étape Sélectionner une source de flux.
- Remplissez le formulaire correspondant à la source du flux :
- Mode d'envoi du flux : sélectionnez HTTPS.
- Fichier sitemap : indiquez l'URL du fichier
sitemap.xml
. - Nom d'utilisateur : saisissez les identifiants pour accéder au serveur HTTPS.
- Mot de passe : saisissez le mot de passe pour accéder au serveur HTTPS.
- Cliquez sur Envoyer.
Une fois la configuration terminée, vous pourrez modifier les paramètres de la source de flux de données sur la page Configuration > Flux.
Configurer un compte de service
Vous avez besoin d'un compte de service pour envoyer des requêtes HTTPS authentifiées aux API Google, telles que l'API de mise à jour en temps réel et la mise à jour des commandes asynchrones.
Pour configurer un compte de service, procédez comme suit:
- Accédez à la console Google Cloud Platform.
- Un compte Google Cloud est également associé à votre compte sur le portail des partenaires. Sélectionnez ce projet, s'il n'est pas déjà sélectionné.
- Cliquez sur Comptes de service dans le menu de gauche.
- Cliquez sur Créer un compte de service.
- Saisissez un nom pour le compte de service, puis cliquez sur Créer.
- Pour Sélectionner un rôle, choisissez Projet > Éditeur.
- Cliquez sur Continuer.
- Facultatif: Ajoutez des utilisateurs pour leur accorder l'accès au compte de service, puis cliquez sur OK.
- Cliquez sur > Créer une clé pour le compte de service que vous venez de créer.
- Sélectionnez le format JSON, puis cliquez sur Créer.
- Une fois la nouvelle paire de clés publique/privée générée, téléchargez-la sur votre ordinateur.
Ajouter une URL de traitement
Pour tester votre intégration, vous devez configurer l'URL de votre API de traitement. L'URL de traitement associe le compte du portail des partenaires au point de terminaison de l'URL de votre service Web, qui héberge votre service Web mis en œuvre conformément au schéma d'action de traitement.
Pour configurer votre URL de traitement, procédez comme suit:
- Sur le portail des partenaires, accédez à Configuration > Endpoints (Configuration > Points de terminaison).
- Ajoutez une URL de traitement des espaces réservés dans le champ de texte de l'onglet Point de terminaison avec Order with Google. À ce stade, l'URL de traitement n'a pas besoin d'être une URL fonctionnelle.
- Cliquez sur Enregistrer les modifications.