Cette page explique comment créer un compte Merchant Center et importer un exemple de produit à l'aide de Merchant API.
Avant de commencer
Activez l'API Merchant dans votre projet 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 Commencer à utiliser Merchant Center.
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
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 {ACCOUNT_ID}, car vous en aurez besoin pour exécuter d'autres requêtes.
Créer une source de données de produits 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 sera disponible pour l'insertion de produits dans quelques minutes.
Vous pouvez consulter cette source de données dans l'interface utilisateur de Merchant Center. Pour en savoir plus, consultez 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 du produit nouvellement créé 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.