Premiers pas avec les services de comparateur de prix (CSS)

Effectuer des opérations de base avec l'API est un bon moyen de commencer à l'utiliser.

Prérequis

Avant de commencer, procédez comme suit :

  • Assurez-vous de disposer d'un compte CSS Center valide.
  • Enregistrez un développeur d'API.
  • Vérifiez que vous avez correctement configuré vos autorisations.
  • Vérifiez que vous avez activé l'API CSS.
  • Vérifiez que vous avez installé les bibliothèques clientes pour votre environnement.

Pour en savoir plus, consultez le guide de démarrage rapide.

Activer l'API CSS

Pour vous inscrire en tant que développeur et utiliser l'API CSS, vous devez associer votre compte CSS Center et votre projet Google Cloud à l'aide de la méthode d'inscription des développeurs, comme suit :

Associez CSS Center à votre projet Google Cloud : l'association est établie automatiquement, car l'appelant a accès au projet Google Cloud en fonction du jeton d'accès ou de la clé API, et est un utilisateur autorisé du compte CSS Center.

Enregistrer un développeur d'API

Ajoutez un utilisateur développeur d'API au compte CSS Center : si un utilisateur existe déjà, il se verra simplement attribuer le nouveau type d'accès "Développeur d'API". Si l'utilisateur est nouveau, il reçoit une invitation par e-mail à rejoindre CSS Center.

Une fois l'enregistrement effectué, vous pouvez afficher l'état de l'enregistrement à l'aide de GetDeveloperRegistration ou annuler l'enregistrement à l'aide de UnregisterGCP. Vous pouvez utiliser l'appel d'enregistrement suivant :

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Une fois la requête exécutée, attendez la réponse suivante :

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Produits CSS

Comme la sous-API Products, l'API CSS fait la distinction entre CssProductInput et ListCssProduct. Insérez un produit avec InsertCssProductInput.

Une fois que nos systèmes internes ont traité le produit (cela peut prendre quelques minutes), récupérez-le avec ListCssProducts.

Identifiez vos produits à l'aide de raw_provided_id. Nous vous recommandons d'utiliser un identifiant que vous utilisez déjà dans votre propre système. Vous pouvez également utiliser l'une des méthodes courantes suivantes pour en créer un :

  • Identifiants uniques globaux (GUID)
  • Identifiants uniques universels (UUID)
  • Attributs de produit uniques concaténés (par exemple, marque_modèle_couleur_taille)

Pour en savoir plus, consultez Insérer/Lister/Mettre à jour/Supprimer un produit.

Opérations de base

Voici quelques requêtes de base que vous pouvez essayer.

  1. Insérez un produit test à l'aide de InsertCssProductInput. Pour obtenir de l'aide sur les attributs à envoyer, consultez cet exemple de code.

  2. Répertoriez tous vos produits à l'aide de ListCssProducts. Notez qu'il existe un léger délai de traitement entre l'insertion d'un produit et son affichage dans la fiche. Si vous n'en voyez pas immédiatement, réessayez après quelques secondes.

  3. Mettez à jour un seul produit à l'aide de UpdateCssProductInput en utilisant votre cssproductinput.name. Vous ne devez envoyer que les attributs à mettre à jour. Pour obtenir un exemple, consultez l'exemple de code.

  4. Supprimez le produit test à l'aide de DeleteCssProductInpu en fournissant le raw_provided_id.

Limites

L'insertion ou la suppression d'un produit individuel peut être lente. Pour améliorer les performances, consultez Utiliser Async pour améliorer les performances. Cela permet d'appeler l'API en parallèle.

Lister et libeller vos comptes

La gestion des libellés dans l'API CSS vous permet d'organiser de manière programmatique vos comptes client Merchant Center à l'aide de tags personnalisés. Cette fonctionnalité vous permet de classer efficacement vos clients (par type ou stratégie, par exemple), ce qui vous aide à mieux vous organiser et à rationaliser vos opérations. Vous pouvez utiliser l'API pour effectuer les fonctions suivantes sur les libellés :