Ü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 özel 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çlanmıştı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. 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ı aşağıda bulabilirsiniz:

{
  "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 aggregateProductStatuses.list sorgu parametresiyle sonuçları filtreleyerek belirli bir ülke ve hedefteki durumu görebilirsiniz. Ö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/{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"
          ]
        }
      ]
    }
  ]
}