खाता स्थिति

अपने 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, और 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 खाते की स्थिति मिलती है:

  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 सबमिट करने पर, HTTP 200 स्टेटस कोड और खाते की स्थिति की सूची JSON फ़ॉर्मैट में मिलेगी.merchantId

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

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

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

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

    3. आपको HTTP 200 स्टेटस कोड मिलेगा. इससे पता चलेगा कि अनुरोध पूरा हो गया है. साथ ही, JSON फ़ॉर्मैट में खाते की स्थिति की सूची मिलेगी.