Ürün istatistiklerini ve sorunlarını görüntüleme

Merchant Center hesabınızdaki ürünlerin durumu hakkında genel bir bakış elde etmek için aggregateProductStatuses.list yöntemini kullanabilirsiniz. Bu, her bir ürünü getirmenize gerek kalmadan ürün verilerinizin genel durumunu izlemek için kullanışlıdır. Bu yöntem, sahip olduğunuz ürünlerin toplam sayısını durumlarına (onaylandı, beklemede, onaylanmadı) göre ayrı ayrı gösterir ve ürünlerinizi etkileyen sorunları listeler.

Dikkat edilmesi gereken noktalar

aggregateProductStatuses.list yöntemini kullanırken dikkat edilmesi gereken özel noktalar vardır.

  • Veri kullanılabilirliği: Bir ürünün eklenmesi veya güncellenmesi ile durumunun aggregateProductStatuses yanıtına yansıması arasında 30 dakikadan uzun bir gecikme olabilir.
  • Sorun tutarlılığı: aggregateProductStatuses.list yöntemi tarafından döndürülen sorun başlıkları ve açıklamalarının, Products API tarafından döndürülen sorunlarla tutarlı olması amaçlanmaktadır. Ancak bu açıklamalar, Merchant Center kullanıcı arayüzünde gösterilen sorun açıklamalarından farklı olabilir.

Tüm ürün durumlarına genel bakış

Bu örnekte, AggregateProductStatus kaynaklarının listesinin nasıl alınacağı gösterilmektedir. Her kaynak, hedef ve ülke kombinasyonuna göre ürünlerin durumunu gösterir. Arama aggregateProductStatuses.list parametresiz olarak yapıldığında hesabınız için kullanılabilir tüm durumlar döndürülür.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/12345/aggregateProductStatuses/FREE_LISTINGS~US",
      "reportingContext": "FREE_LISTINGS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1510",
        "pendingCount": "50",
        "disapprovedCount": "15"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Belirli bir ülke ve hedef için ürün durumlarını alma

aggregateProductStatuses.list yöntemiyle filter sorgu parametresini kullanarak sonuçları belirli bir ülke ve hedefteki durumu görecek şekilde filtreleyebilirsiniz. Örneğin: country = "US" AND reportingContext = "SHOPPING_ADS". Daha fazla bilgi için Filtre söz dizimi başlıklı makaleyi inceleyin.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}