Wyświetlanie statystyk i problemów dotyczących produktu

Możesz użyć aggregateProductStatuses.list, aby uzyskać ogólny przegląd stanu produktów na koncie Merchant Center. Jest to przydatne do monitorowania ogólnego stanu danych o produktach bez konieczności pobierania informacji o każdym produkcie z osobna. Ta metoda podaje łączną liczbę produktów, które masz, podzieloną według stanu (zatwierdzone, oczekujące, odrzucone), a także listę problemów wpływających na Twoje produkty.

Specjalne uwagi

W przypadku korzystania z metody aggregateProductStatuses.list należy wziąć pod uwagę pewne kwestie.

• Dostępność danych: między wstawieniem lub zaktualizowaniem produktu a odzwierciedleniem jego stanu w odpowiedzi aggregateProductStatuses może wystąpić opóźnienie przekraczające 30 minut.
• Spójność problemów: tytuły i opisy problemów zwracane przez metodę aggregateProductStatuses.list powinny być zgodne z problemami zwracanymi przez interfejs Products API. Mogą się one jednak różnić od opisów problemów wyświetlanych w interfejsie Merchant Center.

Omówienie wszystkich stanów produktów

Ten przykład pokazuje, jak pobrać listę zasobów AggregateProductStatus. Każdy zasób reprezentuje stan produktów dla konkretnej kombinacji miejsca docelowego i kraju. Wywołanie aggregateProductStatuses.list bez żadnych parametrów zwraca wszystkie dostępne stany na Twoim koncie.

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

Oto przykładowa odpowiedź po udanym wywołaniu:

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

Sprawdzanie stanu produktów w określonym kraju i miejscu docelowym

Aby wyświetlić stan dla konkretnego kraju i miejsca docelowego, możesz filtrować wyniki za pomocą parametru zapytania filter w metodzie aggregateProductStatuses.list. Na przykład: country = "US" AND reportingContext = "SHOPPING_ADS". Więcej informacji znajdziesz w artykule Składnia filtra.

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

Oto przykładowa odpowiedź po udanym wywołaniu:

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