계정에서 현재 사용할 수 있는 제품에 대한 정보를 가져오려는 경우 특히 해결해야 할 문제가 있는 제품이 있는지 확인하는 데 관심이 있습니다. 판매자 센터에서 이 정보를 가져오는 방법을 알고 있지만 대신 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이면 이 오류로 인해 제품이 게재되지 않습니다.
하지만 mobile_landing_page_crawling_not_allowed 오류와 같이 itemLevelIssues[].servability가 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 플랫폼, 쇼핑 광고 프로그램에서 제품이 즉시 표시되지 않습니다.
이 정보를 토대로 이제 판매자 센터를 방문하여 어떤 문제인지 파악할 필요 없이 중요한 문제를 즉시 알리는 동시에 최종 해결을 위해 덜 심각하지 않은 문제를 수집하는 알림 소프트웨어를 작성할 수 있습니다.