Obter o estado das ofertas do produto

Nota

O recurso ProductStatuses só está disponível para participantes fechados-beta. Para obter informações sobre como participar no programa closed-beta ou open-beta, contacte o gestor de conta.

Todos os elementos de programação e documentação da Store estão sujeitos a alterações durante a versão beta.

Para obter uma lista de ofertas de produtos na loja que têm o respetivo estado definido como Desaprovado ou Aviso, utilize o modelo obter estados de produto.

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

O corpo da resposta é um objeto ProductStatuses . Se o arquivo não contiver produtos com estado Desaprovado ou Aviso, o resources campo contém uma matriz vazia.

{
  "resources": []
}

Eis o aspeto da resposta quando os produtos têm o seu estado definido como Aviso e Desaprovado. O itemLevelIssues campo contém a lista de problemas que deve resolver.

{
  "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"
        }
      ]
    }
  ]
}

Por predefinição, o pedido devolve um máximo de 25 ofertas. Para devolver um número diferente de ofertas, inclua o parâmetro de consulta de resultados máximos .

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"

Se o número de ofertas com o respetivo estado definido como Desaprovado ou Aviso for maior do que o máximo de resultados, a resposta contém o nextPageToken campo.

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

Para obter a página seguinte das ofertas, inclua o parâmetro de consulta continuation-token na próxima chamada e defina-o como o 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..."

Normalmente, o padrão de chamada é chamar este modelo num ciclo até que a resposta não inclua o nextPageToken campo.

Obter contagens de estado de resumo de ofertas de produtos

O recurso ProductStatuses oferece uma vista de resumo do estado das ofertas de produtos numa loja. A vista comunica ofertas aprovadas e desaprovadas, juntamente com ofertas que estão pendentes de revisão ou que estão prestes a expirar.

Para pedir uma vista de resumo, utilize o modelo de vista de resumo. Defina {merchantId} para o ID do arquivo a partir do qual pretende obter a 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

A resposta é um objeto ProductStatusesSummary .

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

Quando o estado de uma oferta é alterado, a vista de resumo pode demorar até duas horas a refletir a alteração.