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

जिन देशों में सीएसएस प्रोग्राम उपलब्ध है वहां कंपैरिज़न शॉपिंग सर्विस (सीएसएस), व्यापारियों या कंपनियों की तरफ़ से 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 का क्वेरी पैरामीटर देना होगा.
• सीएसएस डाेमेन को accountId के तौर पर, उनसे जुड़े Merchant Center खाते का आईडी देना होगा.

ध्यान दें: सिर्फ़ सीएसएस डोमेन और सीएसएस ग्रुप के खातों में लेबल का इस्तेमाल किया जा सकता है. Merchant Center खातों के पास इस लेबल फ़ंक्शन का ऐक्सेस नहीं होता.

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

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

ध्यान दें: Merchant Center खाते पर लेबल लागू करते समय, आपको नाम के बजाय लेबल के id का इस्तेमाल करना होगा. id, अपने-आप लेबल को असाइन हो जाता है. लेबल बनाने के बाद, यह रिस्पॉन्स के तौर पर वापस आ जाता है. id को 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 खातों को फ़िल्टर करने का तरीका बताया गया है. इसके लिए, लेबल बनाने के उदाहरण में बनाए गए कुंजी-खातों के लेबल के id (123) का इस्तेमाल किया जाता है. खातों को वापस पाने के लिए, इस यूआरएल का इस्तेमाल करके GET का अनुरोध करें:

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

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

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

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

ध्यान दें: सीएसएस डाेमेन पर लेबल लागू करते समय, आपको नाम के बजाय लेबल के id का इस्तेमाल करना होगा. id को अपने-आप लेबल को असाइन हो जाता है. लेबल बनाए जाने के बाद, रिस्पॉन्स के तौर पर यह वापस दिखता है. id को accounts.labels.list पर कॉल करके भी फिर से लेबल किया जा सकता है.

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

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

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