Commencer

L'API Manufacturer Center (MfC) permet aux applications d'interagir directement avec la plate-forme Manufacturer Center. Pour vous aider à démarrer, nous proposons des exemples de code Java et .NET.

Ce guide vous aidera à créer votre première application à l'aide de l'API Manufacturer Center. Avant de commencer à coder, vous devez effectuer quelques opérations.

Prise en charge de REST

Notre API REST prend en charge les opérations CRUD de base pour deux types de ressources différents:

  • Produit pour les propriétaires de marque et les partenaires pour les données.
  • ProductCertification pour les organismes de certification.

Le reste de cette documentation sera principalement rédigé pour Product, mais la procédure est similaire pour la ProductCertification.

Configurez votre compte Manufacturer Center

  1. Créez un compte Manufacturer Center.

  2. Veillez à mémoriser ou noter l'adresse e-mail avec laquelle vous avez créé ce compte Manufacturer Center, car vous en aurez besoin plus tard. Dans les captures d'écran, elle est représentée par manufacturer_user@example.com.

Envoyez votre première requête API (sans une ligne de code !)

  1. Accédez à APIs Explorer dans la documentation destinée aux développeurs pour Accounts.Products.list.

  2. Assurez-vous que le compte Google connecté est répertorié dans le paramètre "Utilisateurs" de l'onglet "Paramètres".

  3. Dans APIs Explorer, assurez-vous que Google OAuth 2.0 est sélectionné dans le menu déroulant Authentification:

  4. Dans le champ "Parent" du formulaire, saisissez accounts/{account_id}, en remplaçant {account_id} par l'ID de fabricant de votre compte Manufacturer Center, puis cliquez sur Exécuter.

  5. Une réponse indiquant que l'opération a réussi doit s'afficher. Félicitations ! Vous avez effectué votre première requête API Manufacturer Center.

  6. Si vous n'avez pas encore de produits dans Manufacturer Center, la liste est vide. À ce stade, vous pouvez passer à d'autres requêtes et voir à quoi elles servent. Comme il s'agit d'une API RESTful, toutes les requêtes fonctionnent de la même manière. Une fois que vous avez des produits, vous pouvez essayer Accounts.Products.get.

Créer un projet dans la console Google APIs

Les requêtes adressées à l'API Manufacturer Center sont effectuées via votre projet dans la console API. Nous partons ici du principe que vous accéderez à votre propre compte Manufacturer Center. Nous vous suggérons donc d'utiliser des comptes de service pour simplifier le flux d'authentification. Consultez le guide sur les comptes de service pour savoir comment configurer un nouveau compte de service à utiliser avec votre compte Manufacturer Center.

Votre première requête API autorisée avec Java

Maintenant que vous avez configuré un compte de service et ajouté l'ID de compte de service à votre compte Manufacturer Center, vous pouvez accéder à votre compte à l'aide des exemples de code disponibles. Ce guide s'appuie sur des exemples Java pour illustrer l'utilisation de l'API.

  1. Installez Apache Maven, si ce n'est pas déjà fait.

  2. Téléchargez nos exemples Shopping sur notre page GitHub.

  3. Créez les exemples Java à partir du sous-répertoire java:

    $ mvn compile

  4. Exécutez maintenant le code ProductsListSample (l'exemple pour ProductCertification serait ListProductCertificationsSample) :

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Si vous n'avez pas suivi les instructions de configuration figurant dans le fichier README fourni avec les fichiers sources, vous obtiendrez un message d'erreur indiquant qu'aucun exemple de configuration n'a pu être trouvé. Suivez les instructions du fichier README pour créer le répertoire de configuration et y insérer les informations appropriées. Le fichier JSON que vous avez téléchargé lors de la configuration de votre compte de service doit être placé dans ce répertoire sous le nom de fichier service-account.json. N'oubliez pas d'indiquer au code où se trouve votre fichier en définissant la variable d'environnement suivante.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Maintenant que vous avez défini la configuration des exemples, exécutez à nouveau le code ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. À ce stade, l'exécution du programme Java doit se terminer. Elle doit afficher soit la liste des produits trouvés, soit un message indiquant que votre compte ne contient aucun produit. Si un message d'erreur du type "L'utilisateur ne peut pas accéder au compte 1234567890" s'affiche, c'est probablement parce que vous n'avez pas configuré l'utilisateur du compte de service en tant qu'utilisateur autorisé dans Manufacturer Center. Du point de vue de l'API, le projet de la console API a envoyé une requête au nom d'un utilisateur qui ne figurait pas dans la liste des administrateurs Manufacturer Center autorisés. Par conséquent, cette demande serait bien évidemment refusée.

  8. Vous pouvez tester l'exécution de ProductsListSample autant de fois que vous le souhaitez, car il s'agit d'une requête en lecture seule. Vous pouvez également explorer les autres exemples que nous avons créés pour Java et .NET.