סטטוס חשבון

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

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

המוכרים אחראים לציית להנחיות שופינג פרסומות ובחינם המדיניות בנושא כרטיסי מוצר. Google צוות 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"
      }
     }
    ]
   }
  }
 ]
}

בדיקת המשאב 'סטטוסי חשבון'

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

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

   1. כדי לקבל את merchantId ואת accountId, צריך לבצע GET ל-API נקודת קצה (endpoint):

      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 תקין באמצעות accountID, merchant ID ו-get .

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

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

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