מעבר מ-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 מפורט. בשדה הזה מפורטת ההשפעה של הבעיה, כולל היעד (לדוגמה, מודעות שופינג), האזור הספציפי וחומרת הבעיה באזור הזה.
  • חומרה כסוג מנייה: השדה severity הוא עכשיו סוג מנייה (עם ערכים כמו 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/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 (string), ‏destination (string) impactedDestinations (הודעה חוזרת) ההשפעה מוצגת עכשיו ברשימה, שמקבצת את היעד, האזור והחומרה של כל אזור מושפע. השדה country מוחלף בשדה regionCode בהודעה Impact.
(לא זמין) ‫language_code, time_zone (פרמטרים של בקשה) פרמטרים חדשים בבקשה list מאפשרים לוקליזציה של שדות שקריאים לבני אדם, כמו title ו-detail.
הקודם
Migrate account management
הבא
Migrate accountstatuses to Aggregate Product Statuses