현재 계정에서 사용할 수 있는 제품에 대한 정보를 가져오려고 한다고 가정해 보겠습니다. 특히 제품에 해결해야 할 문제가 있는지 확인하는 것이 좋습니다. 판매자 센터에서 이 정보를 가져오는 방법을 알고 있지만 Content API를 사용하여 자동 알림 시스템을 설정하는 것이 좋습니다. 이 가이드에서는 Content API의 문제 심각도 정보가 판매자 센터의 진단 보고서에 표시된 문제 우선순위에 매핑되는 방식을 설명합니다.
Content API를 사용한 예
제품에 영향을 미치는 문제를 확인하려면 계정에 대해 accountstatuses.get를 실행하면 됩니다. 다음은 반환되는 리소스의 간단한 예시입니다.
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
accountLevelIssues[].severity에서 판매자 센터 계정 오류의 심각도를 확인할 수 있습니다. 오류가 Critical개 있으면 계정이 정지되어 제품 제공이 중지됩니다.
itemLevelIssues에서는 제품 비승인으로 이어질 수 있는 제품 오류를 확인할 수 있습니다. itemLevelIssues[].numItems를 사용하면 계정의 항목 2개에 깨진 이미지 링크가 있으며 5개 항목에 방문 페이지 오류가 있음을 알 수 있습니다.
itemLevelIssues[].servability에서 오류로 인해 영향을 받는 제품이 비승인되었는지 확인할 수 있습니다. 손상된 이미지 링크와 방문 페이지 오류로 인해
제품이 비승인될 수 있습니다.
영향을 받는 모든 제품을 찾으려면 Productstatuses.list를 호출하여 제품별로 전체 문제 목록을 가져옵니다. 이 메서드는 다음과 같은 항목을 반환합니다.
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
이제 계정에 있는 모든 제품의 문제에 대한 정보를 확인했지만 이 문제를 해결하는 것이 얼마나 중요한지 알 수 없습니다.
productstatuses 예에서 itemLevelIssues[].servability를 사용하면 오류로 인해 Buy on Google, 쇼핑 광고 또는 Google 플랫폼에서 제품을 게재하는 기능이 중지되었는지 여부를 확인할 수 있습니다.
ambiguous_gtin 오류와 같이 itemLevelIssues[].servability가 unaffected이면 이 오류로 인해 제품이 게재되지 않는 것은 아닙니다.
하지만 itemLevelIssues[].servability가 mobile_landing_page_crawling_not_allowed 오류와 같이 disapproved이면 오류가 수정될 때까지 제품을 제공할 수 없으므로 훨씬 더 심각한 오류입니다.
accountstatuses 예의 accountLevelIssues[].severity에 있는 판매자 센터의 진단 섹션에는 문제 우선순위와 다양한 우선순위의 의미가 정확하게 정의되어 있습니다.
먼저 보고서를 살펴보겠습니다.
Content API for Shopping에서 얻은 모든 정보는 진단 섹션에 표시되는 정보와 어떤 관련이 있나요? 어떤 항목은 최대한 빨리 해결해야 하는 문제이고, 해결하는 데 적합하지만 꼭 해결해야 할 문제는 아닌 항목은 무엇인가요? 이 문제를 해결하지 않으면 제품이 광고에 더 이상 게재되지 않는 문제는 무엇인가요?
이 예에서 볼 수 있듯이 진단 섹션은 계정 및 해당 계정의 제품에 관한 문제에 대한 심각도 정보를 제공하며 Content API(Accountstatuses 서비스를 통해)는 accountLevel 문제의 심각도 정보만 제공합니다.
각 소스는 문제의 심각도에 따라 문제를 세 가지 카테고리로 나눕니다. 상태 관련 서비스에서 반환된 문제의 심각도를 판단하는 방법을 이해하면 해결해야 할 가장 중요한 문제와 안전하게 무시할 수 있는 문제를 빠르게 파악할 수 있습니다.
문제 우선순위 설정하기
진단 섹션의 문제 우선순위 지정에서는 문제 심각도를 오류, 경고, 알림의 세 가지 수준 중 하나로 설명합니다. 위와 같은 보고서 테이블에서 이 수준은 첫 번째 열에 표시되는 이미지로 표시됩니다. 오류는 
, 경고는 
, 알림은 
에 표시됩니다.
오류로 인해 계정 정지 또는 상품 비승인이 발생했습니다. 항목이 결과에 다시 표시될 수 있도록 가능한 한 빨리 해결해야 합니다.
경고는 광고 실적에 부정적인 영향을 줄 수 있으며, 문제가 해결되지 않으면 향후 상품 또는 계정 정지로 이어질 가능성이 높습니다.
데이터 품질을 향상시키기 위한 최적화 방안으로 알림이 제공됩니다. 이러한 문제를 해결하는 것이 좋지만 필수사항은 아닙니다.
하지만 어떤 오류가 발생했는지 확인하기 위해 판매자 센터를 방문할 필요는 없습니다.
Content API의 accountstatuses 리소스 객체의 accountLevelIssues[].severity 필드는 동일한 문제 심각도 정보를 제공합니다. 이 필드에는 critical, error, suggestion의 세 가지 값 중 하나가 포함될 수 있습니다.
이러한 값은 진단 탭의 문제 우선순위와 일대일로 대응합니다.
| 데이터 품질 문제 심각도 (API) | 문제 우선순위 지정 |
|---|---|
critical |
오류() |
error |
경고(개) |
suggestion |
알림 (개) |
따라서 accountstatuses 예에서 missing_ad_words_link 문제를 통해 광고를 게재하려면 Google Ads 계정을 연결해야 하지만 판매자 센터 데이터베이스의 제품 승인에는 영향을 미치지 않습니다.
반면에 editorial_and_professional_standards_destination_url_down_policy는 계정을 정지하는 더 심각한 오류입니다. Buy on Google, Google 플랫폼 또는 연결된 Google Ads 계정이 있는 경우 critical 오류가 발생하면 Buy on Google, Google 플랫폼, 쇼핑 광고 프로그램에서 제품이 즉시 게재되지 않습니다.
이 정보를 통해 이제 어떤 문제인지 파악하기 위해 판매자 센터를 방문할 필요 없이 최종 해결을 위해 심각하지 않은 문제를 수집하는 동시에 중요한 문제를 즉시 알리는 알림 소프트웨어를 작성할 수 있습니다.