खाता स्थिति

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

किसी गैर-एमसीए खाते (उदाहरण के लिए, स्टैंडअलोन 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. सबमिट किए गए merchantId के लिए, आपको HTTP 200 का स्टेटस कोड और 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 में खाते की स्थिति की सूची मिलेगी.