מעבר מ-accountstatuses ל-Account Issues

השתנה האופן שבו מאתרים בעיות ברמת החשבון שיכולות להשפיע על המוצרים ועל תקינות החשבון. לעומת המשאב accountstatuses ב-Content API for Shopping, ‏ Merchant API כולל משאב ייעודי AccountIssue שמספק מידע מובנה ומפורט יותר.

מידע נוסף על השימוש בתכונה החדשה זמין במדריך הצגת בעיות בחשבון.

הערה: ב-Merchant API, הבעיות ברמת החשבון וסטטוס המוצרים המצטבר מפוצלים. מומלץ גם לעיין במדריך שלנו למעבר מ-accountstatuses אל סטטוסים מצטברים של מוצרים.

ההבדלים העיקריים

ריכזנו כאן את השיפורים וההבדלים העיקריים במשאב Merchant API AccountIssue:

• משאב ייעודי: בעיות בחשבון הן משאב בפני עצמו. ב-Content API for Shopping, בעיות ברמת החשבון היו שדה מקונן במשאב הכללי AccountStatus. באמצעות Merchant API אפשר לפרט אותם ישירות באמצעות method‏ accounts.issues.list.
• נתוני השפעה מובְנים: במשאב AccountIssue יש שדה מפורט impactedDestinations. בשדה הזה מוצג פירוט ברור של ההשפעה של הבעיה, כולל היעד (לדוגמה, מודעות שופינג), האזור הספציפי וחומרת הבעיה באזור הזה.
• חומרה כסוג enum: השדה severity הוא עכשיו סוג enum (עם ערכים כמו CRITICAL, ERROR, SUGGESTION), ולכן קל יותר לעבד אותו באופן פרוגרמטיבי בהשוואה לערכים מבוססי-מחרוזת ב-Content API ל-Shopping.
• מזהים סטנדרטיים: לכל בעיה בחשבון יש מזהה ייחודי של משאב מלא name בפורמט accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. הגישה המתוקננת הזו מחליפה את המחרוזת id מ-Content API for Shopping.
• תמיכה בלוקליזציה: שיטת accounts.issues.list מאפשרת לציין language_code כדי לקבל פרטי בעיה, כמו שם ותיאור, בשפה המועדפת. אי אפשר היה לעשות את זה ב-Content API for Shopping.
• התנהגות מתקדמת של החשבון: כשקוראים ל-accounts.issues.list בחשבון מתקדם, הפונקציה מחזירה רק בעיות שרלוונטיות ישירות לחשבון המתקדם הזה. הוא לא מחזיר בעיות בחשבונות המשנה שלו. ב-Content API for Shopping, השיטה accountstatuses.list תחזיר את הסטטוסים של כל חשבונות המשנה. כדי לקבל בעיות לגבי כל חשבונות המשנה ב-Merchant API, צריך להפעיל את accounts.listSubaccounts ואז להפעיל את accounts.issues.list לכל חשבון משנה בנפרד.

בקשות

ב-Merchant API, אפשר לראות רשימה של בעיות בחשבון Merchant Center ספציפי.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues

השוואה של כתובות URL של בקשות

תיאור הבקשה	Content API for Shopping	Merchant API
הצגת בעיות ברמת החשבון בחשבון יחיד	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues
הצגת רשימה של בעיות ברמת החשבון בכל חשבונות המשנה של חשבון מתקדם	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	לא זמין. צריך לבצע איטרציה בחשבונות משנה.

מזהים

המזהים של חשבונות ובעיות השתנו ב-Merchant API.

השוואת מזהים

תיאור המזהה	Content API for Shopping	Merchant API
מזהה החשבון	‫{MERCHANT_ID} ו-{ACCOUNT_ID} כפרמטרים של נתיב.	‫{ACCOUNT_ID} כפרמטר נתיב בפורמט accounts/{ACCOUNT_ID}.
מזהה הבעיה	השדה id בגוף התשובה (לדוגמה, "products-that-enable-dishonest-behavior-hacking-policy").	השדה name בגוף התשובה, שהוא השם המלא של המשאב (לדוגמה, accounts/12345/issues/example-issue-id).

Methods

השיטות לאחזור בעיות בחשבון אוחדו ופשוטות יותר ב-Merchant API.

השוואה בין שיטות

Content API for Shopping	Merchant API	זמינות והערות
accountstatuses.get	accounts.issues.list	זמין. כדי לקבל בעיות בחשבון יחיד, משתמשים ב-accounts.issues.list ומציינים את מזהה החשבון. ל-Merchant API אין שיטה get לגיליון בודד.
accountstatuses.list	אין מקבילה ישירה.	לא זמין. השיטה accounts.issues.list ב-Merchant API מחזירה רק בעיות בחשבון שצוין, ולא בחשבונות המשנה שלו. כדי לקבל בעיות עבור כל חשבונות המשנה, צריך קודם להתקשר אל accounts.listSubaccounts ואז אל accounts.issues.list עבור כל חשבון משנה.
accountstatuses.custombatch	אין מקבילה ישירה.	לא זמין. אין תמיכה בעיבוד אצווה של בעיות בחשבון ב-Merchant API. צריך לבצע listקריאות נפרדות לכל חשבון.

שינויים מפורטים בשדות

עדכנו את השדות במשאב של בעיות בחשבון כדי לספק יותר מבנה ובהירות.

השוואה בין שדות

Content API for Shopping	Merchant API	תיאור
accountLevelIssues (מערך ב-AccountStatus)	accountIssues (מערך ב-ListAccountIssuesResponse)	הבעיות הן עכשיו משאב ייעודי ברמה העליונה, ולא שדה מוטמע.
id (מחרוזת)	name (מחרוזת)	מזהה הבעיה הוא עכשיו שם משאב מלא, לדוגמה accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (מחרוזת)	title (מחרוזת)	ללא שינוי.
detail (מחרוזת)	detail (מחרוזת)	ללא שינוי.
documentation (מחרוזת)	documentationUri (מחרוזת)	שם השדה שונה כדי לציין שמדובר בכתובת URL.
severity (מחרוזת)	severity (enum)	מידת החומרה היא עכשיו טיפוס enum מובנה (CRITICAL, ‏ ERROR, ‏ SUGGESTION) במקום מחרוזת.
‫country (string), ‏ destination (string)	impactedDestinations (הודעה חוזרת)	ההשפעה מוצגת עכשיו ברשימה, שמקובצים בה היעד, האזור והחומרה של כל אזור מושפע. השדה country מוחלף ב-regionCode בהודעה Impact.
(לא זמין)	‫language_code, time_zone (פרמטרים של בקשה)	פרמטרים חדשים בבקשת list מאפשרים לוקליזציה של שדות שקריאים לבני אדם, כמו title ו-detail.