सीएसएस लेबल को मैनेज करना

जिन देशों में सीएसएस प्रोग्राम उपलब्ध है वहां कंपैरिज़न शॉपिंग सर्विस (सीएसएस) का इस्तेमाल करके, Google पर शॉपिंग विज्ञापन दिखाए जा सकते हैं. Content API की मदद से, सीएसएस डोमेन और सीएसएस ग्रुप, लेबल का इस्तेमाल करके अपने खातों को व्यवस्थित कर सकते हैं. सीएसएस डोमेन, डोमेन से जुड़े Merchant Center खातों को लिस्ट, लेबल, और फ़िल्टर कर सकते हैं. सीएसएस ग्रुप, ग्रुप से जुड़े सीएसएस डोमेन को लेबल कर सकते हैं और उनकी सूची बना सकते हैं. Content API की ये सेवाएं, Comparison Shopping Service Center में उपलब्ध कुछ सुविधाओं के प्रोग्रामैटिक वर्शन उपलब्ध कराती हैं.

सीएसएस के बारे में ज़्यादा जानने के लिए, कंपैरिज़न शॉपिंग सर्विस पर जाएं. सीएसएस सेंटर में लेबल इस्तेमाल करने के बारे में जानकारी पाने के लिए, Comparison Shopping Service Center में मौजूद खातों के लिए लेबल इस्तेमाल करना लेख पढ़ें.

सीएसएस खाते के टाइप

सीएसएस, इन तीन तरह के खातों का इस्तेमाल करती हैं:

  • सीएसएस ग्रुप, टॉप-लेवल के खाते होते हैं. इनमें एक या उससे ज़्यादा सीएसएस डोमेन शामिल हो सकते हैं.
  • सीएसएस डोमेन, सीएसएस के खाते होते हैं. ये खाते, कारोबारियों या कंपनियों की ओर से शॉपिंग विज्ञापन दिखाते हैं. हर सीएसएस डोमेन, सिर्फ़ एक सीएसएस ग्रुप से जुड़ा हो सकता है.
  • Merchant Center खाते उन कारोबारियों या कंपनियों के लिए होते हैं जिनके लिए सीएसएस डोमेन, शॉपिंग विज्ञापन दिखाते हैं. सीएसएस को कई तरह के Merchant Center खातों से जोड़ा जा सकता है. इनमें एक से ज़्यादा क्लाइंट वाले खाते (एमसीए) और अलग-अलग कारोबारी या कंपनी के खाते शामिल हैं. हर Merchant Center खाते को सिर्फ़ एक सीएसएस डोमेन से जोड़ा जा सकता है. Merchant Center खातों के अलग-अलग टाइप के बारे में ज़्यादा जानने के लिए, Comparison Shopping Service Center में मौजूद अलग-अलग तरह के खाते लेख पढ़ें.

सीएसएस लेबल टाइप

सीएसएस दो तरह के लेबल इस्तेमाल करती हैं:

  • मैन्युअल लेबल, सीएसएस डाेमेन बनाते हैं और उन्हें Merchant Center खातों को असाइन करते हैं. साथ ही, सीएसएस ग्रुप, सीएसएस डाेमेन को मैन्युअल लेबल असाइन करते हैं.
  • अपने-आप बनने वाले लेबल, CSS Center की मदद से अपने-आप बनते हैं और Merchant Center खातों को असाइन किए जाते हैं. ऑटोमैटिक लेबल, अलग-अलग तरह की खाता मेट्रिक के लिए उपलब्ध होते हैं. इनकी मदद से, अहम खातों और खाते की अहम गतिविधि की पहचान की जा सकती है.

लेबल के टाइप के बारे में ज़्यादा जानने के लिए, Comparison Shopping Service Center में मौजूद खातों के लिए लेबल इस्तेमाल करना लेख पढ़ें. इसमें अपने-आप लागू होने वाले लेबल के बारे में भी बताया गया है.

सीएसएस के लिए Content API के फ़ंक्शन और एंडपॉइंट

Content API, सीएसएस के लिए ये एंडपॉइंट उपलब्ध कराता है:

  • accounts.labels: इसकी मदद से, सीएसएस डोमेन और Merchant Center खातों पर लागू करने के लिए लेबल बनाए, वापस पाए, और उनमें बदलाव किए जा सकते हैं. उदाहरण के लिए, लेबल बनाना देखें.
  • accounts.updatelabels: इसकी मदद से, किसी एक Merchant Center खाते पर लेबल लागू किए जा सकते हैं. उदाहरण के लिए, Merchant Center खाते में लेबल लागू करना लेख पढ़ें.
  • accounts.list: इसकी मदद से, किसी सीएसएस डोमेन से जुड़े सभी Merchant Center खातों को वापस पाया जा सकता है. साथ ही, हर खाते पर लागू किए गए लेबल भी वापस पाए जा सकते हैं. जुड़े हुए खातों का सबसेट पाने के लिए, लेबल id के हिसाब से भी फ़िल्टर किया जा सकता है. उदाहरण के लिए, Merchant Center खातों को फ़िल्टर करने के लिए लेबल का इस्तेमाल करना लेख पढ़ें.
  • accounts.get: इसकी मदद से, किसी एक Merchant Center खाते पर लागू किए गए लेबल वापस पाए जा सकते हैं.
  • csses: इसकी मदद से, लेबल और सीएसएस डोमेन के बीच के असोसिएशन देखे जा सकते हैं और उन्हें मैनेज किया जा सकता है. उदाहरण के लिए, सीएसएस डाेमेन पर लेबल लागू करना लेख पढ़ें.

सीएसएस डोमेन के तौर पर accounts एंडपॉइंट को कॉल करते समय, इन ज़रूरी शर्तों का ध्यान रखें:

  • सीएसएस डोमेन को merchantId के बजाय cssId एट्रिब्यूट की वैल्यू देनी होगी.
  • सीएसएस डोमेन को view=CSS का क्वेरी पैरामीटर देना होगा.
  • सीएसएस डोमेन को अपने Merchant Center खाते का आईडी, accountId एट्रिब्यूट की वैल्यू के तौर पर देना होगा.
की सुविधा का ऐक्सेस नहीं होता.

उदाहरण: लेबल बनाना

नया लेबल बनाने के लिए, accounts.labels.create तरीके का इस्तेमाल किया जा सकता है. लेबल, सीएसएस डोमेन और Merchant Center खातों पर लागू किए जा सकते हैं. हालांकि, अलग-अलग तरह के खातों के लिए लेबल अलग-अलग होते हैं और इनका इस्तेमाल एक-दूसरे की जगह नहीं किया जा सकता. डोमेन-लेवल का लेबल बनाने के लिए, सीएसएस डोमेन आईडी को accountId के तौर पर इस्तेमाल करें. इस लेबल को डोमेन से जुड़े Merchant Center खातों पर लागू किया जा सकता है. ग्रुप-लेवल का लेबल बनाने के लिए, सीएसएस ग्रुप आईडी का इस्तेमाल करें. इस लेबल को ग्रुप से जुड़े सीएसएस डोमेन पर लागू किया जा सकता है. लेबल बनाते समय, सीएसएस ग्रुप आईडी को accountId के तौर पर इस्तेमाल करें.

यहां दिए गए उदाहरण में, डोमेन-लेवल के मुख्य खातों का लेबल बनाने का तरीका बताया गया है. इसे डोमेन से जुड़े Merchant Center खातों पर लागू किया जा सकता है. लेबल बनाने के लिए, इस यूआरएल और अनुरोध के मुख्य हिस्से का इस्तेमाल करके POST अनुरोध करें:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

उदाहरण: किसी Merchant Center खाते पर लेबल लागू करना

सीएसएस डोमेन से जुड़े Merchant Center खाते को लेबल असाइन करने के लिए, accounts.updatelabels तरीके का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में बताया गया है कि पिछले उदाहरण में बनाए गए key-accounts लेबल को अपने किसी सबसे अहम Merchant Center खाते पर कैसे लागू करें.

accounts.labels.list

लेबल लागू करने के लिए, यहां दिए गए यूआरएल और अनुरोध के मुख्य हिस्से का इस्तेमाल करके POST अनुरोध करें:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

उदाहरण: Merchant Center खातों को फ़िल्टर करने के लिए लेबल का इस्तेमाल करना

किसी सीएसएस डोमेन से जुड़े Merchant Center खातों में लेबल बनाने और उन्हें लागू करने के बाद, accounts.list तरीके का इस्तेमाल किया जा सकता है. साथ ही, अपने अनुरोध में लेबल क्वेरी पैरामीटर पास किया जा सकता है, ताकि सिर्फ़ उस लेबल वाले खाते दिखाए जा सकें. यहां दिए गए उदाहरण में, सीएसएस डोमेन से जुड़े Merchant Center खातों को फ़िल्टर करने का तरीका बताया गया है. इसके लिए, लेबल बनाना उदाहरण में बनाए गए key-accounts लेबल के id (123) का इस्तेमाल किया गया है. खाते वापस पाने के लिए, यहां दिए गए यूआरएल का इस्तेमाल करके GET अनुरोध करें:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

अनुरोध के मुख्य हिस्से की ज़रूरत नहीं है.

उदाहरण: किसी सीएसएस डोमेन पर लेबल लागू करना

सीएसएस ग्रुप से जुड़े किसी सीएसएस डोमेन को लेबल असाइन करने के लिए, csses.updatelabels तरीके का भी इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में बताया गया है कि accounts.labels.create तरीके का इस्तेमाल करके बनाए गए key-domains ग्रुप-लेवल के लेबल को, अपने सबसे ज़रूरी सीएसएस डोमेन खातों में से किसी एक पर कैसे लागू करें. ध्यान रखें कि सीएसएस डोमेन और Merchant Center खातों के लेबल अलग-अलग होते हैं. ग्रुप-लेवल के लेबल, सीएसएस ग्रुप आईडी का इस्तेमाल करके बनाए जाने चाहिए. इसके लिए, accountId के तौर पर सीएसएस ग्रुप आईडी का इस्तेमाल करना होगा.

लेबल लागू करने के लिए, यहां दिए गए यूआरएल और अनुरोध के मुख्य हिस्से का इस्तेमाल करके POST अनुरोध करें:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}