États des produits

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

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 produit
  • lastUpdateDate: date de la dernière mise à jour du produit
  • googleExpirationDate: date d'expiration du produit
  • destinationStatuses: 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 un nextPageToken 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ème
  • severity: 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ème
  • detail: informations supplémentaires sur le problème
  • documentation: URL de la documentation sur le problème
  • applicableCountries: indique les pays dans lesquels le problème affecte le produit.