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

Merchant Center hesabınızdaki ürünlerin durumuyla ilgili üst düzey bir genel bakış elde etmek için aggregateProductStatuses.list yöntemini kullanabilirsiniz. Bu özellik, her bir ürünü ayrı ayrı 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, ürünlerin belirli bir hedef ve ülke kombinasyonundaki durumunu gösterir. Parametre içermeyen aggregateProductStatuses.list çağrısı, hesabınızla ilgili tüm kullanılabilir durumları döndürür.

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

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

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

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

filter yöntemini kullanarak belirli bir ülke ve hedefteki durumu görmek için sonuçları aggregateProductStatuses.list sorgu parametresiyle filtreleyebilirsiniz. Örneğin: country = "US" AND reportingContext = "SHOPPING_ADS". Filtre söz dizimi hakkında daha ayrıntılı 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:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}
Önceki
Display issues and solutions to businesses