Vous pouvez utiliser Merchant API pour importer et gérer vos produits par programmation. La ressource accounts.products vous permet de créer un catalogue de boutique en ligne, qui correspond à la liste des produits et des offres. Pour en savoir plus sur l'importation et la gestion de vos produits à l'aide de Merchant API, consultez la section Présentation de Merchant Products API.
Modifications des ressources
Les ressources products et productstatuses de l'API Content sont remplacées par les ressources productInputs et products.
Vous pouvez utiliser la ressource productInputs de l'API Merchant pour importer vos informations produit. La ressource product de l'API Merchant peut être utilisée pour récupérer vos produits traités, y compris leurs états.
Exigences concernant la source de données
Dans l'API Merchant, vous devez spécifier la source de données cible lorsque vous importez des produits. Il peut s'agir d'une source de données principale ou d'une source de données supplémentaire. Vous pouvez récupérer vos sources de données existantes à l'aide de dataSources.list ou en créer une à l'aide de dataSources.create.
Vous pouvez également utiliser l'interface utilisateur de Merchant Center pour gérer vos sources de données.
Pour en savoir plus sur les sources de données, et découvrir comment les créer et les gérer, consultez la présentation de l'API Merchant Data Sources.
Modifications des identifiants
Merchant API utilise le nom pour identifier le produit. Le nom du produit doit respecter le format accounts/{account}/products/{product}, où {product} doit être au format channel~language~feedLabel~offerId.
Les ressources Content API utilisaient : au lieu de ~ entre chaque valeur de l'ID :
channel:language:feedLabel:offerId.
Tous les appels d'API Merchant renvoient le nouveau format avec ~ entre les valeurs de l'ID. Nous vous recommandons de stocker le nouveau champ name à partir de la réponse et de l'utiliser dans vos futurs appels.
Méthodes
Voici une comparaison des méthodes de produits dans Content API for Shopping et l'API Merchant Products:
| Content API for Shopping | API Merchant Products |
|---|---|
| products.custombatch | Non disponible |
| products.insert | productInputs.insert |
| products.update | Pas encore disponible |
| products.delete | productInputs.delete |
| products.get | products.get |
| products.list | products.list |
| productstatuses.custombatch | Non disponible |
| productstatuses.get | products.get |
| productstatuses.list | products.list |
Demandes
| Méthode Content API | URL dans Content API for Shopping | URL dans l'API Merchant Products | Identifiant dans Content API | Identifiant dans l'API Merchant Products |
|---|---|---|---|---|
products.insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
Non disponible | ||
products.delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |