Premiers pas avec l'API Merchant

Cette page explique comment créer un compte Merchant Center et importer un exemple de produit à l'aide de l'API Merchant.

Avant de commencer

Activez l'API Merchant dans votre projet Google Cloud.

Si l'intégration de l'API est utilisée dans AppScript avec le service Shopping Content, un projet Google Cloud par défaut est créé et le service Merchant API est activé automatiquement. Toutefois, vous devez toujours effectuer un enregistrement unique en tant que développeur avant d'utiliser l'API Merchant. Pour en savoir plus, consultez Utiliser le service Merchant API dans Apps Script.

Accéder à Google Cloud

Créer un compte

Pour utiliser l'API Merchant, vous devez disposer d'un compte Merchant Center. Pour créer un compte Merchant Center, consultez Premiers pas avec Merchant Center.

Accéder à Merchant Center

S'inscrire comme développeur

Pour utiliser l'API Merchant, vous devez associer votre compte Merchant Center et votre projet Google Cloud à l'aide de la méthode d'enregistrement du développeur, comme suit :

  1. Associez Merchant Center à votre projet Google Cloud : l'association est approuvée automatiquement, car l'appelant dispose d'un jeton d'accès ou d'une clé API valides provenant du projet Google Cloud et est un utilisateur autorisé du compte Merchant Center.

  2. Ajoutez un utilisateur développeur d'API au compte Merchant Center : l'API d'enregistrement ajoute un utilisateur développeur d'API au compte Merchant Center. Si un utilisateur existe déjà, il se verra attribuer le nouveau type d'accès. Si l'utilisateur est nouveau, il recevra une invitation par e-mail pour Merchant Center.

Nous vous recommandons d'utiliser la méthode accounts.users.create pour ajouter des développeurs d'API supplémentaires ou de secours. Vous pourrez ainsi continuer à disposer d'une inscription de développeur valide si la personne quitte votre organisation ou est supprimée.

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.

L'appel d'inscription est

POST https://merchantapi.googleapis.com/accounts/v1beta/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"]
  }
}

Une fois le développeur d'API enregistré, vous pouvez utiliser la méthode accounts.users.patch pour lui attribuer des rôles supplémentaires, tels que STANDARD et ADMIN.

Obtenir votre ID de compte

Vous pouvez obtenir l'ID de compte à l'aide de la méthode accounts.list.

Vous pouvez utiliser Google APIs Explorer pour exécuter des requêtes de l'API Merchant. APIs Explorer utilise Google OAuth 2.0 pour l'authentification. Avant d'exécuter les requêtes, assurez-vous que la case Google OAuth 2.0 est cochée.

Pour vous authentifier à l'aide d'OAuth 2.0, vous devez vous connecter à votre compte Google, puis à l'explorateur d'API. Vous devez également autoriser APIs Explorer à gérer vos fiches produit et vos comptes.

La requête suivante montre comment récupérer votre ID de compte :

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

ou

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

Une fois la requête exécutée, la réponse suivante s'affiche :

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

Copiez le {ACCOUNT_ID}, car vous en aurez besoin pour exécuter d'autres requêtes.

Créer une source de données produit principale

Pour insérer un produit, vous avez besoin d'une source de données produit principale. La requête suivante montre comment créer une source de données que vous pouvez utiliser pour insérer un produit dans votre compte :

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Remplacez {ACCOUNT_ID} par l'ID du compte Merchant Center que vous avez créé.

Une fois cette requête exécutée, la réponse suivante s'affiche :

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Copiez la valeur du champ name, car vous en aurez besoin pour insérer un produit.

La source de données créée est disponible pour l'insertion de produits au bout de quelques minutes.

Vous pouvez consulter cette source de données dans l'UI Merchant Center. Pour en savoir plus, consultez Comment trouver l'onglet "Sources de données" ?

Insérer un produit

Pour insérer un exemple de produit dans votre compte, exécutez la requête suivante :

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Remplacez {DATASOURCE_NAME} par la valeur que vous avez copiée précédemment.

Une fois cette requête exécutée, la réponse suivante s'affiche :

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

L'ID produit du nouveau produit est online~en~US~tshirt-123. Vous pouvez utiliser la méthode accounts.products.get pour récupérer des informations sur ce produit. Vous pouvez également utiliser l'UI Merchant Center pour afficher ce produit.