제품 통계 및 문제 보기

aggregateProductStatuses.list 메서드를 사용하여 판매자 센터 계정의 제품 상태에 대한 대략적인 개요를 확인할 수 있습니다. 이 메서드는 개별 제품을 모두 가져오지 않고도 제품 데이터의 전반적인 상태를 모니터링하는 데 유용합니다. 이 메서드는 상태 (승인됨, 대기 중, 비승인)별로 분류된 총 제품 수를 제공하고 제품에 영향을 미치는 문제를 나열합니다.

특별 고려사항

aggregateProductStatuses.list 메서드를 사용할 때는 특별히 고려해야 할 사항이 있습니다.

• 데이터 사용 가능 여부: 제품이 삽입 또는 업데이트된 시점과 해당 상태가 aggregateProductStatuses 응답에 반영되는 시점 사이에 30분 이상 지연될 수 있습니다.
• 문제 일관성: aggregateProductStatuses.list 메서드에서 반환되는 문제 제목과 설명은 Products API에서 반환되는 문제와 일관성을 유지하도록 설계되었습니다. 그러나 판매자 센터 사용자 인터페이스에 표시되는 문제 설명과는 다를 수 있습니다.

모든 제품 상태 개요 보기

이 예에서는 AggregateProductStatus 리소스 목록을 검색하는 방법을 보여줍니다. 각 리소스는 대상 유형과 국가의 특정 조합에 대한 제품 상태를 나타냅니다. 매개변수 없이 aggregateProductStatuses.list를 호출하면 계정의 사용 가능한 모든 상태가 반환됩니다.

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

다음은 성공적인 호출의 샘플 응답입니다.

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

특정 국가 및 대상 유형의 제품 상태 가져오기

aggregateProductStatuses.list 메서드와 함께 filter 쿼리 매개변수를 사용하여 결과를 필터링하여 특정 국가 및 대상 유형의 상태를 확인할 수 있습니다. 예를 들면: country = "US" AND reportingContext = "SHOPPING_ADS"입니다. 자세한 내용은 필터 구문을 참고하세요.

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

다음은 성공적인 호출의 샘플 응답입니다.

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