Ürün tekliflerinizin durumunu alma

Not

ProductStatuses kaynağı yalnızca kapalı beta katılımcıları tarafından kullanılabilir. Kapalı beta veya açık beta programına katılma hakkında bilgi için lütfen hesap yöneticinize başvurun.

Tüm Store programlama öğeleri ve belgeleri beta sırasında değiştirilebilir.

Mağazanızda durumu Onaylanmadı veya Uyarı olarak ayarlanmış ürün tekliflerinin listesini almak için ürün durumlarını alma şablonunu kullanın.

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

Yanıt gövdesi bir ProductStatuses nesnesidir. Mağaza Onaylanmadı veya Uyarı durumlarına sahip ürünler içermiyorsa, resources alanda boş bir dizi bulunur.

{
  "resources": []
}

Ürünlerin durumu Uyarı ve Onaylanmadı olarak ayarlandığında yanıt şöyle görünür. alanı itemLevelIssues , çözmeniz gereken sorunların listesini içerir.

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

Varsayılan olarak, istek en fazla 25 teklif döndürür. Farklı sayıda teklif döndürmek için max-results sorgu parametresini ekleyin.

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"

Durumu Onaylanmadı veya Uyarı olarak ayarlanmış teklif sayısı maksimum sonuçlardan büyükse, yanıt alanı nextPageToken içerir.

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

Tekliflerin sonraki sayfasını almak için bir sonraki çağrınıza continuation-token sorgu parametresini ekleyin ve belirteci olarak ayarlayın.

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..."

Genellikle çağrı düzeni, yanıt alanı içermeyene kadar bu şablonu döngüde çağırmaktır nextPageToken .

Ürün tekliflerinin özet durum sayılarını alma

ProductStatuses kaynağı, bir mağazadaki ürün tekliflerinin durumunun özet görünümünü sunar. Görünüm, onaylanan ve onaylanmamış tekliflerin yanı sıra gözden geçirmeyi bekleyen veya süresi dolmak üzere olan teklifleri raporlar.

Özet görünümü istemek için özet görünümü şablonunu kullanın. Görünümün görüntülenmesini istediğiniz mağazanın kimliğine ayarlayın {merchantId} .

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

Yanıt bir ProductStatusesSummary nesnesidir.

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

Teklifin durumu değiştiğinde, özet görünümünün değişikliği yansıtması iki saat kadar sürebilir.