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

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

Specjalne uwagi

Podczas korzystania z metody aggregateProductStatuses.list należy wziąć pod uwagę kilka kwestii.

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

Wyświetlanie stanu wszystkich produktów

Ten przykład pokazuje, jak pobrać listę zasobów AggregateProductStatus. Każdy zasób reprezentuje stan produktów w przypadku określonej kombinacji miejsca docelowego i kraju. Wywołanie metody 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ź na udane wywołanie:

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

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

Możesz filtrować wyniki, aby wyświetlić stan w określonym kraju i miejscu docelowym, używając parametru zapytania filter z metodą aggregateProductStatuses.list. Na przykład: country = "US" AND reportingContext = "SHOPPING_ADS". Więcej informacji znajdziesz w artykule Składnia filtrów.

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

Oto przykładowa odpowiedź na udane wywołanie:

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