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

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

सीएसएस के बारे में ज़्यादा जानकारी के लिए, कंपैरिज़न शॉपिंग सर्विस देखें. CSS 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 खातों पर लागू किए जा सकते हैं. हालांकि, अलग-अलग तरह के खातों के लिए लेबल अलग-अलग होते हैं. इसलिए, इनका इस्तेमाल एक-दूसरे की जगह पर नहीं किया जा सकता. डोमेन-लेवल का लेबल बनाने के लिए, जिसे डोमेन से जुड़े Merchant Center खातों पर लागू किया जा सकता है. लेबल बनाते समय, सीएसएस डाेमेन आईडी को accountId के तौर पर इस्तेमाल करें. ग्रुप-लेवल लेबल बनाने के लिए, जिसे ग्रुप से जुड़े सीएसएस डोमेन पर लागू किया जा सकता है. लेबल बनाते समय, सीएसएस ग्रुप आईडी को 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 तरीके का इस्तेमाल किया जा सकता है. इस उदाहरण में, पिछले उदाहरण में बनाए गए मुख्य खाते लेबल को, अपने सबसे अहम Merchant Center खातों में से एक पर लागू करने का तरीका बताया गया है.

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

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

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

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

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

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

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

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

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

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

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

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