Avant de lancer une application qui demande des identifiants utilisateur pour l'API Data Manager à des utilisateurs externes, votre projet Google Cloud doit passer par la validation de l'application Google OAuth.
Ce guide décrit les transitions de configuration d'audience recommandées pendant le développement et les étapes à suivre pour valider l'application Google OAuth.
Phases d'audience de l'application
En fonction de votre étape de développement, configurez la page "Audience" dans la console Google Cloud avec différents paramètres Type d'utilisateur et État de publication. Suivez ces phases pour une transition en douceur des tests initiaux au lancement en production.
Phase 1 : Développement initial (tests)
Lorsque vous commencez à développer et à tester des requêtes API de base :
- État de publication : défini sur Test.
Type d'utilisateur :
Si votre projet Google Cloud appartient à une organisation Google Workspace et que seuls les utilisateurs de votre organisation utilisent l'application, sélectionnez Interne.
Sinon, sélectionnez Externe.
Utilisateurs de test : si vous définissez le type d'utilisateur sur Externe, cliquez sur Ajouter des utilisateurs pour ajouter manuellement les comptes Google que vous utilisez pour générer des identifiants. Seuls les comptes Google listés peuvent autoriser l'application, et les limites de test et règles d'expiration des jetons s'appliquent.
Validation : non requise pendant les tests. Si vous utilisez Externe, les utilisateurs test voient un écran d'avertissement confirmant qu'ils ont un accès test à une application non validée avant de passer à l'écran de consentement.
Phase 2 : Lancement imminent (envoi de la demande de validation)
Lorsque votre intégration est terminée, que votre interface utilisateur est créée et que vous prévoyez de lancer votre application dans le mois à venir :
- État de publication : passe à En production.
- Type d'utilisateur : définissez cette option sur Externe si votre application s'adresse à des clients extérieurs à votre organisation, tels que des clients annonceurs.
- Action : envoyez votre application pour validation. La procédure de validation de l'application Google OAuth peut prendre plusieurs semaines. Envoyez-la donc dès que possible une fois votre UI prête.
- Gestion des premiers testeurs : pendant l'examen de validation, votre application reste non validée pour les utilisateurs externes. Si vous devez intégrer des testeurs bêta en avance :
- Informez-les qu'ils verront l'écran "Appli non validée".
- Demandez-leur de continuer en cliquant sur Paramètres avancés, puis sur Accéder à APP_NAME (site dangereux).
Exigences de validation des applications
Pour envoyer votre application pour validation dans le Centre de validation, configurez vos paramètres Google Auth Platform et préparez les éléments de validation requis.
Champs d'application de la validation
Sur la page "Accès aux données", ne demandez que les champs d'application dont votre application a besoin. L'API Data Manager utilise des champs d'application sensibles :
https://www.googleapis.com/auth/datamanager(champ d'application principal)https://www.googleapis.com/auth/datamanager.partnerlink(pour les liens partenaires)
Coordonnées
L'équipe de validation Google OAuth envoie toutes les communications aux propriétaires du projet et aux éditeurs du projet configurés dans votre projet Google Cloud. Maintenez ces coordonnées à jour dans la console Google Cloud pour ne pas manquer les demandes d'informations.
Vidéo de démonstration
Fournissez un lien vers une vidéo de démonstration accessible au public (par exemple, une vidéo YouTube non répertoriée ou un lien Google Drive public) montrant comment votre application utilise les champs d'application demandés.
Assurez-vous que la vidéo respecte les exigences concernant les vidéos de démonstration des fonctionnalités de l'application.
Phase 3 : Prêt pour le lancement (validé)
Une fois que l'équipe de validation Google OAuth vous a informé qu'elle a approuvé votre demande de validation d'application, aucune action n'est requise. Votre application est désormais validée, et les utilisateurs externes peuvent l'autoriser sans voir l'écran d'avertissement indiquant qu'elle n'est pas validée.