דף זה תורגם על ידי Cloud Translation API.

סטטוס חשבון

אתם יכולים להשתמש במקור המידע 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 עם method 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 שלהם:

קבלת סטטוס של חשבון משנה של חשבון MCA באמצעות accountstatuses.get.
1. כדי לקבל את merchantId ואת accountId, מבצעים GET לנקודת הקצה של ה-API:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. אתם אמורים לקבל את קוד הסטטוס HTTP 200 כדי להצליח ואת רשימת הסטטוסים של החשבון ב-JSON.
הצגת כל הסטטוסים של חשבון משנה של חשבון MCA באמצעות accountstatuses.list.
1. מבצעים GET לנקודת הקצה של ה-API באמצעות ה-merchantId:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. אתם אמורים לקבל את קוד הסטטוס HTTP 200 בהצלחה ואת רשימת הסטטוסים של החשבון ב-JSON של המסמך merchantId שנשלח.
צפייה בכמה חשבונות משנה של 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.