खाता स्थिति

अपने Merchant Center खाते या एमसीए (एक से ज़्यादा क्लाइंट वाला खाता) और उससे जुड़े सभी उप-खातों की स्थिति देखने के लिए, accountstatuses संसाधन का इस्तेमाल किया जा सकता है.

ऐसे कारोबारी जिनके पास एक से ज़्यादा ऑनलाइन स्टोर या अलग-अलग वेबसाइटों पर बेचे जाने वाले ब्रैंड हैं, वे एमसीए के तहत उप-खाते बना सकते हैं.

शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग से जुड़ी नीतियों का पालन करना व्यापारियों/कंपनियों/कारोबारियों की ज़िम्मेदारी है. अगर हमें इन नीतियों का उल्लंघन करने वाला कॉन्टेंट या व्यवहार मिलता है, तो Google Shopping के पास इन नीतियों को लागू करने और सही कार्रवाई करने का अधिकार सुरक्षित है.

खाते की सामान्य समस्याओं के बारे में जानने के लिए, खाते की समस्याएं वाला रेफ़रंस देखें.

accountstatuses.get

किसी व्यापारी खाते की स्थिति की जानकारी देखने के लिए, accountstatuses.get का इस्तेमाल किया जा सकता है.

destination पैरामीटर का इस्तेमाल करके, यह कंट्रोल किया जा सकता है कि प्रॉडक्ट की कौनसी समस्याएं दिखेंगी. जब डेस्टिनेशन तय नहीं किया जाता है, तो डिफ़ॉल्ट रिस्पॉन्स में destination: Shopping की स्थितियां शामिल होती हैं.

यहां अनुरोध का एक उदाहरण दिया गया है. इसमें, merchantId, एमसीए खाते का आईडी है और accountId उस एमसीए का उप-खाता है:

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

किसी स्टैंडअलोन खाते की स्थिति की जानकारी पाने के लिए, accountstatuses.get पर कॉल करें. साथ ही, merchantId और accountId के लिए, एक ही खाता आईडी का इस्तेमाल करें.

इस तरीके से खाते और सामान के लेवल की समस्याएं दिखाई जाती हैं. accountstatuses.get के रिस्पॉन्स में मिले accountLevelIssues को ठीक करने के लिए, शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग के संसाधनों का इस्तेमाल किया जा सकता है.

यहां उस उप-खाते के लिए रिस्पॉन्स का उदाहरण दिया गया है जिसे "लैंडिंग पेज काम नहीं कर रहा है" उल्लंघन की वजह से निलंबित किया गया था.

{
 "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 का इस्तेमाल करें.

प्रॉडक्ट की समस्याओं को डेस्टिनेशन के हिसाब से फ़िल्टर करने के लिए, accountstatuses.list के साथ फ़िल्टर का इस्तेमाल किया जा सकता है. डेस्टिनेशन की जानकारी न देने पर, रिस्पॉन्स में destination: Shopping के लिए स्टेटस शामिल होते हैं.

एमसीए 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"
     }
    }
   ]
  }
 ]
}

बिना एमसीए खाते (जैसे, कोई स्टैंडअलोन Merchant Center खाता) के accountstatuses.list पर किए जाने वाले कॉल से, 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'."
 }
}

बैच मोड

GET तरीके वाला accountstatuses.custombatch, एक से ज़्यादा क्लाइंट वाले खाते में मौजूद कई उप-खातों के लिए, खाते की स्थिति की जानकारी दिखाता है.

अनुरोध वाले JSON में, एमसीए खाता नंबर का merchantId, उप-खाते का accountId, यूनीक batchId, और get पर सेट किया गया method शामिल होता है.

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

अनुरोध का एक सैंपल नीचे दिया गया है:

{
  "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 को शामिल किया गया है:

1. accountstatuses.get का इस्तेमाल करके, किसी एमसीए के लिए उप-खाते की स्थिति पाएं.

   1. एपीआई एंडपॉइंट से GET करके, merchantId और accountId पाएं:

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

   2. आपको सफलता के लिए HTTP 200 स्टेटस कोड और JSON में खाते की स्थिति की सूची मिलेगी.

2. accountstatuses.list का इस्तेमाल करके, किसी एमसीए के सभी उप-खातों की स्थिति देखें.

   1. अपने merchantId की मदद से, एपीआई एंडपॉइंट पर GET का इस्तेमाल करें:

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

   2. आपको सफलता के लिए HTTP 200 स्टेटस कोड और सबमिट किए गए merchantId के लिए, JSON में खाते की स्थिति की सूची मिलेगी.

3. accountstatuses.custombatch का इस्तेमाल करके, एमसीए के लिए बैच मोड में एक से ज़्यादा उप-खाते देखें.

   1. अपने accountID, merchant ID, और get तरीके का इस्तेमाल करके मान्य JSON बनाएं.

   2. एपीआई एंडपॉइंट पर पोस्ट करें:

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

   3. आपको सफलता के लिए HTTP 200 स्टेटस कोड और JSON में खाते की स्थिति की सूची मिलेगी.