खाता स्थिति

अपने 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

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

यह तरीका, खाते और आइटम के लेवल की समस्याएं दिखाता है. 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"
     }
    }
   ]
  }
 ]
}

एमसीए (एक से ज़्यादा क्लाइंट वाला खाता) से जुड़े खाते के लिए accountstatuses.list को कॉल करने पर, 403 गड़बड़ी दिखती है. उदाहरण के लिए, स्टैंडअलोन Merchant Center खाता.

यहां स्टैंडअलोन खाते के लिए, 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 फ़ॉर्मैट में खाते की स्थिति की सूची मिलेगी.