계정에서 현재 사용할 수 있는 제품에 관한 정보를 가져오려고 한다고 가정해 보겠습니다. 특히 해결해야 할 문제가 있는 제품이 있는지 알고 싶어 합니다. 판매자 센터에서 이 정보를 가져오는 방법을 알고 있지만 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을 사용하여 오류로 인해 Google에서 구매, 쇼핑 광고 또는 Google 플랫폼에서 제품을 게재할 수 없는지 확인할 수 있습니다.
itemLevelIssues[].servability이 ambiguous_gtin 오류와 같은 unaffected인 경우 오류로 인해 제품이 게재되지 않습니다.
하지만 itemLevelIssues[].servability가 mobile_landing_page_crawling_not_allowed 오류와 같이 disapproved인 경우 오류가 수정될 때까지 제품을 게재할 수 없으므로 훨씬 더 심각한 오류입니다.
accountstatuses 예시에서 accountLevelIssues[].severity 아래의 판매자 센터의 진단 섹션은 문제 우선순위와 다양한 우선순위의 정확한 의미를 정의합니다.
먼저 보고서를 살펴보세요.
Content API for Shopping에서 가져오는 모든 정보는 진단 섹션에 표시되는 정보와 어떤 관련이 있나요? 어떤 항목이 최대한 빨리 해결해야 하는 문제이고, 어떤 항목이 해결하면 좋지만 필수는 아닌가요? 해결되지 않은 경우 광고에 제품이 게재되지 않는 문제는 무엇인가요?
이 예에 표시된 것처럼 진단 섹션에서는 계정 및 해당 계정의 제품에 관한 문제의 심각도 정보를 제공하는 반면 콘텐츠 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는 계정을 정지시키는 더 심각한 오류입니다. 'Google에서 구매', 'Google 전반의 표시 경로'에 참여하고 있거나 연결된 Google Ads 계정이 있는 경우 critical 오류로 인해 제품이 'Google에서 구매', 'Google 전반의 표시 경로', 쇼핑 광고 프로그램에 즉시 게재되지 않습니다.
이 정보를 바탕으로 판매자 센터를 방문하여 심각한 문제와 덜 심각한 문제를 구분하지 않고도 심각한 문제를 즉시 알리고 덜 심각한 문제는 나중에 해결할 수 있도록 수집하는 알림 소프트웨어를 작성할 수 있습니다.