סטטוס חשבון

במשאב accountstatuses תוכלו לראות את הסטטוס של חשבון Merchant Center או של חשבון MCA (חשבון מרובה לקוחות) ואת כל חשבונות המשנה שמשויכים אליו.

מוכרים שיש להם כמה חנויות וירטואליות או מותגים שנמכרים באתרים נפרדים, יכולים לבחור אם לנהל חשבונות משנה תחת חשבון MCA.

המוכרים אחראים לציית למדיניות בנושא מודעות שופינג ולמדיניות בנושא כרטיסי מוצר חינמיים. ב-Google שופינג שמורה הזכות לאכוף את כללי המדיניות האלה ולהגיב בהתאם במקרה שבו אנחנו מוצאים תוכן או התנהגות שמפרים את המדיניות.

במאמר בעיות בחשבון תוכלו לקרוא פרטים על בעיות נפוצות בחשבון.

accountstatuses.get

אפשר להשתמש ב-accountstatuses.get כדי להציג את פרטי הסטטוס של חשבון מוכר יחיד.

אפשר להשתמש בפרמטר destination כדי לקבוע אילו בעיות במוצרים יוחזרו. אם לא מציינים יעד, תגובת ברירת המחדל כוללת את הסטטוסים של destination: Shopping.

הנה בקשה לדוגמה, שבה merchantId הוא מספר חשבון MCA וה-accountId הוא חשבון משנה של חשבון ה-MCA הזה:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

כדי לקבל מידע על סטטוס החשבון של חשבון עצמאי, צריך לבצע קריאה ל-accountstatuses.get עם אותו מספר חשבון ב-merchantId וב-accountId.

שיטה זו מחזירה בעיות ברמת החשבון והפריט. ניתן להשתמש במשאבים מודעות שופינג וכרטיסי מוצר חינמיים כדי לתקן את הערך accountLevelIssues שהוחזר מ-accountstatuses.get.

הנה דוגמה לתגובה לחשבון משנה שהושעה עקב הפרה של 'דף נחיתה לא פועל'.

{
 "kind": "content#accountStatus",
 "accountId": "123456789",
 "websiteClaimed": true,
 "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"
    },
    {
     "code": "missing_condition_microdata",
     "servability": "unaffected",
     "resolution": "merchant_action",
     "description": "Missing or invalid data [condition]",
     "detail": "Add valid structured data markup to your landing page",
     "documentation": "https://support.google.com/merchants/answer/6183460",
     "numItems": "5"
    },
    {
     "code": "mobile_landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable mobile landing page",
     "detail": "Update your website or landing page URL to enable access from mobile devices",
     "documentation": "https://support.google.com/merchants/answer/6098296",
     "numItems": "3"
    }
   ]
  }
 ]
}

accountstatuses.list

אפשר להשתמש ב-accountstatuses.list כדי להציג מידע על סטטוס החשבון בכל חשבונות המשנה של חשבון ה-MCA.

אפשר להשתמש במסננים עם accountstatuses.list כדי לסנן בעיות במוצרים לפי יעד. אם לא מציינים יעד, התגובה כוללת סטטוסים של destination: Shopping.

הנה בקשה לדוגמה לקבלת מידע על סטטוס החשבון בכל חשבונות המשנה של חשבון ה-MCA merchantId:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

זוהי דוגמה לתשובה:

{
 "kind": "content#accountstatusesListResponse",
 "resources": [
  {
   "kind": "content#accountStatus",
   "accountId": "1234567",
   "websiteClaimed": true,
   "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": "0",
      "expiring": "0"
     }
    }
   ]
  },
  {
   "kind": "content#accountStatus",
   "accountId": "123456789",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "home_page_issue",
     "title": "Website URL not provided",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/176793"
    },
    {
     "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": "0",
      "expiring": "0"
     }
    }
   ]
  }
 ]
}

קריאה ל-accountstatuses.list של חשבון שאינו MCA (למשל חשבון Merchant Center עצמאי) מחזירה את השגיאה 403.

הנה דוגמה לתשובה לקריאה ל-accountstatuses.list עבור חשבון עצמאי:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "111111111 is not a multi-client account (MCA). The only account
                service operations allowed on non-MCAs are 'get', 'update',
                'authinfo' and 'claimwebsite'."
   }
  ],
  "code": 403,
  "message": "111111111 is not a multi-client account (MCA). The only account
              service operations allowed on non-MCAs are 'get', 'update',
              'authinfo' and 'claimwebsite'."
 }
}

מצב אצווה

פונקציית accountstatuses.custombatch עם שיטת GET מחזירה את פרטי סטטוס החשבון עבור כמה חשבונות משנה בחשבון מרובה לקוחות.

קובץ ה-JSON של הבקשה כולל את ה-merchantId של מספר החשבון ה-MCA, את accountId של חשבון המשנה, batchId ייחודי ואת method שמוגדר ל-get.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

לפניכם דוגמה לגוף הבקשה בקובץ JSON:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

לפניכם דוגמה לגוף של תגובת JSON:

{
 "kind": "content#accountstatusesCustomBatchResponse",
 "entries": [
  {
   "batchId": 9,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1212121212",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "home_page_issue",
      "title": "Website URL not provided",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/176793"
     },
     {
      "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": "0",
       "expiring": "0"
      }
     }
    ]
   }
  },
  {
   "batchId": 99,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1313131313",
    "websiteClaimed": true,
    "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": "0",
       "expiring": "0"
      }
     }
    ]
   }
  }
 ]
}

בדיקת המשאב 'סטטוסים של חשבונות'

בדוגמה הבאה אנחנו מקבלים את הסטטוסים של חשבונות MCA, פירוט שלהם:custombatch.get

1. קבלת הסטטוס של חשבון משנה של חשבון MCA באמצעות accountstatuses.get.

   1. משיגים את merchantId ואת accountId על ידי ביצוע GET לנקודת הקצה של ה-API:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      

   2. קוד הסטטוס HTTP 200 אמור להישלח בהצלחה ואת רשימת הסטטוסים של החשבון בקובץ JSON.

2. הצגת כל הסטטוסים של חשבונות משנה של חשבון MCA באמצעות accountstatuses.list.

   1. מבצעים GET לנקודת הקצה של ה-API באמצעות merchantId:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      

   2. כדי להצליח, קוד הסטטוס HTTP 200 אמור להישלח, ורשימת הסטטוסים של החשבון בקובץ JSON תישלח עם merchantId.

3. הצגת כמה חשבונות משנה של חשבון MCA במצב אצווה באמצעות accountstatuses.custombatch.

   1. יצירת JSON תקין באמצעות method accountID, merchant ID ו-get.

   2. מבצעים POST לנקודת הקצה של ה-API:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
      

   3. קוד הסטטוס HTTP 200 אמור להישלח בהצלחה ואת רשימת הסטטוסים של החשבון בקובץ JSON.