Obtención del estado de las ofertas de productos

Nota:

El recurso ProductStatuses solo está disponible para los participantes de la versión beta cerrada. Para obtener información sobre cómo participar en el programa closed-beta o open-beta, póngase en contacto con el administrador de cuentas.

Todos los elementos de programación y la documentación de la Tienda están sujetos a cambios durante la versión beta.

Para obtener una lista de ofertas de productos en la tienda que tienen su estado establecido en Desaprobado o Advertencia, use la plantilla Obtener estados de producto.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses

El cuerpo de la respuesta es un objeto ProductStatuses . Si el almacén no contiene productos con estados Desaprobado o Advertencia, el resources campo contiene una matriz vacía.

{
  "resources": []
}

Este es el aspecto de la respuesta cuando los productos tienen su estado establecido en Advertencia y No aprobado. El itemLevelIssues campo contiene la lista de problemas que debe solucionar.

{
  "resources": [
    {
      "productId": "online:en:CA:9",
      "title": "Slip Resistant - Shoes For Crews...",
      "status": "Warning",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "GtinPlusBrandRequiredWarn",
          "description": "Missing one or more identifiers - The Brand and GTIN or Brand and MPN are required.",
          "servability": "Unaffected"
        }
      ]
    },

    . . .

    {
      "productId": "online:en:CA:7",
      "title": "No Slip - Shoes For Crews...",
      "status": "Disapproved",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "EVRejectedErr",
          "description": "The offer was rejected by the external validation component: EV.",
          "servability": "Disapproved"
        },
        {
          "code": "EV_39",
          "description": "Trademark content",
          "servability": "Disapproved"
        }
      ]
    }
  ]
}

De forma predeterminada, la solicitud devuelve un máximo de 25 ofertas. Para devolver un número diferente de ofertas, incluya el parámetro de consulta max-results .

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5"

Si el número de ofertas con su estado establecido en No aprobado o Advertencia es mayor que max-results, la respuesta contiene el nextPageToken campo .

{
  "nextPageToken": "W3sidG9rZW4iOm51bGwsInJhbmdlIjp7Im1pbiI6IjA1QzFFNTNEMUYwRjg2IiwibWF4IjoiMDVDMUU1NUIyRDk3NEEifX1d",
  "resources": [...]
}

Para obtener la siguiente página de ofertas, incluya el parámetro de consulta de token de continuación en la siguiente llamada y establézcalo en el token.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5&continuation-token=W3sidG9rZW4iOm..."

El patrón de llamada normalmente consiste en llamar a esta plantilla en un bucle hasta que la respuesta no incluya el nextPageToken campo.

Obtención de recuentos de estado de resumen de las ofertas de productos

El recurso ProductStatuses ofrece una vista de resumen del estado de las ofertas de productos en una tienda. La vista informa de ofertas aprobadas y desaprobadas junto con ofertas que están pendientes de revisión o que están a punto de expirar.

Para solicitar una vista de resumen, use la plantilla de vista de resumen. Establezca {merchantId} en el identificador del almacén desde el que desea la vista.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatusessummary

La respuesta es un objeto ProductStatusesSummary .

{
  "merchantId":12345,
  "approved":189,
  "expiring":14,
  "disapproved":3,
  "pending":10
}

Cuando cambia el estado de una oferta, la vista de resumen puede tardar hasta dos horas en reflejar el cambio.