שינינו את הדרך שבה אתם יכולים לאחזר בעיות ברמת החשבון שיכולות להשפיע על המוצרים ועל תקינות החשבון. בהשוואה למשאב accountstatuses ב-Content API for Shopping, ב-Merchant API יש משאב AccountIssue ייעודי שמספק מידע מובנה ומפורט יותר.
במדריך לצפייה בבעיות בחשבון מוסבר איך להשתמש בתכונה החדשה.
הערה: ב-Merchant API, הבעיות ברמת החשבון והסטטוסים המצטברים של המוצרים מופרדים. מומלץ גם לעיין במדריך שלנו למעבר מ-accountstatuses לסטטוסים מצטברים של מוצרים.
ההבדלים העיקריים
הנה השיפורים וההבדלים העיקריים במשאב AccountIssue של Merchant API:
- משאב ייעודי: בעיות בחשבון הן משאב בפני עצמו. ב-Content API for Shopping, בעיות ברמת החשבון היו שדה בתצוגת עץ בתוך המשאב הכללי
AccountStatus. ב-Merchant API אפשר להציג אותם ישירות באמצעות השיטה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 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/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 |
אין מקבילה ישירה. | לא זמין. ה-method 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. |