Commencer

L'API Manufacturer Center (MfC) permet aux applications d'interagir directement avec la plate-forme Manufacturer Center. Pour vous aider dans vos premiers pas, 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 pouvoir commencer à coder, vous devez effectuer certaines opérations.

Assistance REST

Notre API REST est compatible avec 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.
  • et ProductCertification pour les organismes de certification.

Le reste de cette documentation sera principalement rédigé pour Product, mais le processus devrait être similaire pour ProductCertification.

Configurer votre compte Manufacturer Center

  1. Créez un compte Manufacturer Center.

  2. Veillez à mémoriser l'adresse e-mail que vous avez utilisée pour créer ce compte Manufacturer Center, car vous en aurez besoin ultérieurement. Dans les captures d'écran, elle est représentée par manufacturer_user@example.com.

Envoyez votre première requête API (sans 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 Authentication (Authentification) :

  4. Saisissez accounts/{account_id}, en remplaçant {account_id} par l'ID Manufacturer Center de votre compte Manufacturer Center, dans le champ "Parent" du formulaire, 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 aucun produit dans Manufacturer Center, la liste est vide. À ce stade, vous pouvez accéder à d'autres requêtes et voir ce qu'elles font. 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, une bonne étape consiste à essayer Accounts.Products.get.

Créer un projet dans la console Google APIs

Les requêtes adressées à l'API Manufacturer Center sont envoyées via votre projet dans la console API. Ici, nous supposons que vous accédez à votre propre compte Manufacturer Center. Nous vous suggérons donc de simplifier le flux d'authentification à l'aide de comptes de service. Consultez le guide Service Accounts pour savoir comment configurer un nouveau compte de service à utiliser avec votre compte Manufacturer Center.

Votre première requête API autorisée utilisant 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 utilise les exemples Java pour montrer comment utiliser l'API.

  1. Si ce n'est pas déjà fait, installez Apache Maven.

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

  3. Dans le sous-répertoire java, créez les exemples Java:

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

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. Si vous n'avez pas suivi les instructions de configuration du 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 de ce fichier pour créer le répertoire de configuration et pour y insérer les informations appropriées. Le fichier JSON que vous avez téléchargé lors de la configuration du compte de service doit être placé dans ce répertoire sous le nom de fichier service-account.json. Pensez à 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 est terminée, et une liste des produits trouvés ou un message indiquant qu'il n'y avait aucun produit dans votre compte doivent être imprimés. Si vous obtenez un message d'erreur tel que "L'utilisateur ne peut pas accéder au compte 1234567890", cela est probablement dû au fait 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 console API a envoyé une requête pour le compte d'un utilisateur qui ne figurait pas dans la liste des administrateurs Manufacturer Center autorisés. Par conséquent, cette requête est 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.