États des produits

Vous pouvez utiliser la ressource Product pour afficher l'état détaillé de votre Produits Shopping.

Avec Content API, vous pouvez récupérer l'état d'un produit en appelant la méthode ProductStatuses.get. Avec l'API Merchant, vous pouvez récupérer le produit l'état en récupérant la ressource Accounts.Products.

Vous êtes tenu de respecter les Règles de avec des annonces et sans frais des fiches. Annonces Shopping se réserve le droit d'appliquer ces règles et de répondre de manière appropriée si nous de trouver du contenu ou des comportements qui ne respectent pas ces règles.

Conditions requises

Pour consulter 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: <ph type="x-smartling-placeholder">
      </ph>
    • 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 ne s'affiche dans la réponse que si le produit a au niveau des articles au moment de votre demande.

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 a 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 modifier vos données.

Problèmes au niveau des articles

Chaque problème au niveau des articles comprend 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 reporting auquel s'applique le problème.
  • description: description du problème
  • detail: informations supplémentaires sur le problème
  • documentation: URL de la documentation décrivant le problème
  • applicableCountries: indique les pays dans lesquels le problème affecte le produit.