Commencer

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

L'API Manufacturer Center 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 pouvoir coder, vous devez effectuer certaines opérations.

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 plus tard. Dans les captures d'écran, elle apparaît sous la forme manufacturer_user@example.com.

Effectuez 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. Vérifiez 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 de fabricant provenant de votre compte Manufacturer Center, puis cliquez sur Exécuter dans le champ "Parent".

    Remarque:Si vous n'avez pas encore accordé l'autorisation OAuth2, vous serez invité à autoriser l'appel.

  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 ne contiendra aucun produit. À ce stade, vous pouvez accéder à d'autres requêtes et examiner leur rôle. 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, nous vous recommandons d'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 du principe que vous accéderez à votre propre compte Manufacturer Center. Par conséquent, nous vous suggérons 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.

Remarque:Si vous souhaitez appeler des clients disposant de leurs propres comptes Manufacturer Center, consultez le guide Autoriser les requêtes.

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

Maintenant que vous avez configuré un compte de service et ajouté l'ID de ce compte à votre compte Manufacturer Center, vous pouvez accéder à votre compte à l'aide des exemples de code disponibles. Ce guide utilise les exemples Java pour illustrer l'utilisation de 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 :

    $ 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, un message d'erreur s'affichera, 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.

  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 et affiche la liste des produits trouvés, ou un message indiquant que votre compte ne contient aucun produit. Si vous obtenez une erreur telle 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 au nom d'un utilisateur qui ne figurait pas dans la liste des administrateurs Manufacturer Center autorisés. Par conséquent, cette requête est é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.