제품 통계 및 문제 보기

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

특별 고려사항

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

• 데이터 사용 가능 여부: 제품이 삽입되거나 업데이트된 시점과 상태가 aggregateProductStatuses 응답에 반영되는 시점 사이에 30분 이상의 지연이 발생할 수 있습니다.
• 문제 일관성: aggregateProductStatuses.list 메서드에서 반환되는 문제 제목과 설명은 Products API에서 반환되는 문제와 일관되도록 설계되었습니다. 하지만 Merchant Center 사용자 인터페이스에 표시되는 문제 설명과 다를 수 있습니다.

모든 제품 상태 개요 보기

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

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

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

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

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

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