فرض کنید می خواهید اطلاعاتی در مورد محصولات موجود در حساب خود دریافت کنید. به طور خاص، شما علاقه مند به دانستن اینکه آیا هر یک از محصولات شما دارای مشکلاتی هستند که نیاز به رسیدگی دارند، هستید. شما می دانید چگونه می توانید این اطلاعات را از Merchant Center دریافت کنید، اما ترجیح می دهید با استفاده از Content API یک سیستم هشدار خودکار راه اندازی کنید. در این راهنما، نحوه ترسیم اطلاعات شدت مشکل در Content API را با اولویت بندی مشکل که در گزارش‌های عیب‌یابی در Merchant Center مشاهده می‌شود، بررسی خواهیم کرد.
مثال با 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 ، شدت خطاهای حساب Merchant Center را مشاهده می کنید. خطاهای 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، تبلیغات خرید، یا Surfaces در سراسر Google غیرفعال می‌کند یا خیر.
اگر itemLevelIssues[].servability مانند خطای ambiguous_gtin تحت تأثیر قرار unaffected ، این خطا مانع از ارائه محصول شما نمی شود.
با این حال، اگر itemLevelIssues[].servability مانند خطای mobile_landing_page_crawling_not_allowed disapproved ، این خطای بسیار جدی‌تر است زیرا تا زمانی که خطا برطرف نشود، نمی‌توانید محصول خود را ارائه دهید.
در مثال accountstatuses ما، در قسمت accountLevelIssues[].severity ، بخش Diagnostics در Merchant Center اولویت بندی مسائل و معنای دقیق اولویت های مختلف را تعریف می کند.
ابتدا نگاهی به گزارش بیاندازید:
چگونه همه اطلاعاتی که از Content API for Shopping دریافت می کنید با آنچه در بخش Diagnostics می بینید مرتبط است؟ کدام ورودی‌ها مسائلی هستند که باید در اسرع وقت آنها را برطرف کنید، و رفع کدام یک از آنها خوب است، اما رفع آنها ضروری نیست؟ در صورت عدم توجه، کدام مسائل مانع از نمایش محصولات شما در تبلیغات شما می شود؟
همانطور که در این مثال ها نشان داده شده است، بخش Diagnostics اطلاعات شدت در مورد مشکلات حساب و محصولات موجود در آن حساب را ارائه می دهد، در حالی که Content API (از طریق سرویس Accountstatuses ) اطلاعات شدت را فقط برای مشکلات accountLevel ارائه می دهد.
هر منبع مسائل را بر اساس شدت موضوع به سه دسته تقسیم می کند. درک نحوه قضاوت در مورد شدت مسائل بازگردانده شده از سرویس های مربوط به وضعیت می تواند به سرعت مشخص شود که کدام مسائل مهم ترین هستند و کدام مسائل را می توان با خیال راحت نادیده گرفت.
اولویت بندی موضوع
در بخش Diagnostics، اولویت‌بندی مشکل، شدت مشکل را به عنوان یکی از سه سطح توصیف می‌کند: خطاها، هشدارها و اعلان‌ها. در جداول گزارش مانند جدول بالا، این سطوح با تصاویری که در ستون اول ظاهر می شوند نشان داده می شوند: 
برای خطاها، 
برای هشدارها، و 
برای اطلاعیه ها
خطاها باعث تعلیق حساب یا عدم تأیید مورد شده است. آنها باید در اسرع وقت حل شوند تا اطمینان حاصل شود که موارد واجد شرایط برای نمایش مجدد در نتایج هستند.
هشدارها می توانند بر عملکرد تبلیغات شما تأثیر منفی بگذارند و احتمالاً در آینده منجر به تعلیق موارد یا حساب می شوند مگر اینکه مشکل حل شود.
اعلان ها بهینه سازی های پیشنهادی برای افزایش کیفیت داده ها هستند. حل این مشکلات توصیه می شود، اما لازم نیست.
برای اینکه بفهمیم کدام خطاها کدام است، نیازی نیست به Merchant Center مراجعه کنیم. در Content API، قسمت accountLevelIssues[].severity در اشیاء منبع accountstatuses همان اطلاعات شدت مشکل را ارائه می دهد. این فیلدها می توانند شامل یکی از سه مقدار critical ، error و suggestion باشند.
این مقادیر مطابقت یک به یک با اولویت‌بندی مسئله در برگه عیب‌یابی دارند:
| شدت مشکل کیفیت داده (API) | اولویت بندی موضوع |
|---|---|
critical | خطا ( ) |
error | هشدار ( ) |
suggestion | اطلاع رسانی ( ) |
بنابراین در مثال accountstatuses ما، مشکل missing_ad_words_link به شما این امکان را می‌دهد که بدانید باید یک حساب Google Ads را برای ارائه تبلیغات پیوند دهید، اما بر تایید محصول در پایگاه داده Merchant Center شما تأثیری نخواهد داشت. از سوی دیگر، editorial_and_professional_standards_destination_url_down_policy خطای شدیدتری است که حساب شما را به حالت تعلیق در می آورد. اگر در Buy on Google، Surfaces در سراسر Google شرکت می‌کنید، یا اگر یک حساب Google Ads مرتبط داشته‌اید، یک خطای critical باعث می‌شود محصولات شما بلافاصله در برنامه‌های Buy on Google، Surfaces در سراسر Google و Shopping Ads ارائه نشوند.
با داشتن این اطلاعات، اکنون می‌توانید نرم‌افزار هشداری بنویسید که در عین جمع‌آوری مشکلات کمتر جدی برای رفع نهایی، بدون نیاز به بازدید از Merchant Center، فوراً به مسائل مهم توجه شما را جلب می‌کند.