Ü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 kullanın. 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, reddedildi) 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 bunlar, 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, belirli bir hedef ve ülke kombinasyonundaki ü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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

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

filter yöntemini kullanarak aggregateProductStatuses.list sorgu parametresiyle belirli bir ülke ve hedefteki durumu görmek için sonuçları filtreleyin. Ö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ı 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/en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/en~US~SKU003"
          ]
        }
      ]
    }
  ]
}
Önceki
Display issues and solutions to businesses