Vous pouvez utiliser la ressource Product
pour afficher l'état détaillé de vos produits Shopping.
Avec Content API, vous pouvez récupérer l'état du produit en appelant la méthode ProductStatuses.get
. Avec l'API Merchant Center, vous pouvez récupérer l'état du produit en récupérant la ressource Accounts.Products
.
Vous devez respecter les règles relatives aux annonces Shopping et aux fiches sans frais. Les annonces Shopping se réservent le droit de faire appliquer ces règles et de prendre les mesures appropriées si nous détectons du contenu ou un comportement qui ne les respecte pas.
Conditions requises
Pour afficher l'état des produits, procédez comme suit:
- Enregistrez votre compte dans une destination.
- Indiquez un code pays valide dans l'un des éléments suivants :
- Le champ
feedLabel
- Le champ
shipping
- Au niveau du flux
- Dans les paramètres de livraison de votre compte
- Le champ
Obtenir l'état d'un produit
Récupérez la ressource Accounts.Products
pour afficher l'état d'un produit.
Voici un exemple de requête GET
:
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
Toutes les réponses de products.get
incluent les champs suivants:
creationDate
: date de création du produitlastUpdateDate
: date de la dernière mise à jour du produitgoogleExpirationDate
: date d'expiration du produitdestinationStatuses
: destinations prévues pour le produit.itemLevelIssues
: liste de tous les problèmes associés au produit
Le champ itemLevelIssues
n'apparaît dans la réponse que si le produit présente des problèmes au niveau des articles au moment de votre requête.
Voici un exemple de réponse JSON:
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "288000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
Lister tous les états des produits
Utilisez products.list
pour afficher tous vos produits et leur état.
Vous pouvez utiliser les paramètres suivants pour affiner votre requête:
pageToken
: permet d'obtenir les pages de résultats suivantes Chaque page possède unnextPageToken
que vous pouvez utiliser pour obtenir la page suivante dans la séquence.maxResults
: nombre maximal de résultats par page
Voici un exemple de requête list
avec les paramètres de requête facultatifs:
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
Voici un exemple de réponse JSON:
{
"nextPageToken": "632fd090c95712c6",
"products": [
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/10355371287",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "28800000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
]
}
L'appel productstatuses.list
peut être testé sans risque en production, car il ne modifie pas vos données.
Problèmes au niveau des articles
Chaque problème au niveau des articles inclut les champs suivants:
code
: code d'erreur du problèmeseverity
: gravité du problème.resolution
: indique si le marchand peut résoudre le problème.attribute
: nom de l'attribut affectéreportingContext
: contexte de signalement auquel le problème s'applique.description
: description du problèmedetail
: informations supplémentaires sur le problèmedocumentation
: URL de la documentation sur le problèmeapplicableCountries
: indique les pays dans lesquels le problème affecte le produit.