מעבר מ-accountstatuses ל-Account Issues

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

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

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

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

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

• משאב ייעודי: בעיות בחשבון הן משאב בפני עצמו. ב-Content API for Shopping, בעיות ברמת החשבון היו שדה מקונן במשאב הכללי AccountStatus. באמצעות Merchant API אפשר לקבל רשימה שלהם ישירות באמצעות method‏ accounts.issues.list.
• נתוני השפעה מובְנים: במשאב AccountIssue יש שדה מפורט impactedDestinations. בשדה הזה מפורטת ההשפעה של הבעיה, כולל היעד (לדוגמה, מודעות שופינג), האזור הספציפי וחומרת הבעיה באזור הזה.
• חומרה בתור enum: השדה severity הוא עכשיו enum (עם ערכים כמו CRITICAL, ERROR, SUGGESTION), ולכן קל יותר לעבד אותו באופן פרוגרמטיבי בהשוואה לערכים מבוססי-מחרוזת ב-Content API for Shopping.
• מזהים סטנדרטיים: לכל בעיה בחשבון יש מזהה ייחודי של משאב מלא name בפורמט accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. הגישה המתוקננת הזו מחליפה את המחרוזת id מ-Content API for Shopping.
• תמיכה בלוקליזציה: באמצעות השיטה accounts.issues.list אפשר לציין language_code כדי לקבל פרטי בעיות, כמו שם ותיאור, בשפה המועדפת. אי אפשר היה לעשות את זה ב-Content API לשופינג.
• התנהגות מתקדמת של החשבון: כשמתקשרים אל 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/v1/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/v1/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 (מחרוזת), destination (מחרוזת)	impactedDestinations (הודעה חוזרת)	ההשפעה מוצגת עכשיו ברשימה, עם קיבוץ של היעד, האזור והחומרה של כל אזור מושפע. השדה country מוחלף ב-regionCode בהודעה Impact.
(לא זמין)	‫language_code, time_zone (פרמטרים של בקשה)	פרמטרים חדשים בבקשה list מאפשרים לוקליזציה של שדות שקריאים לבני אדם, כמו title ו-detail.