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

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

सीएसएस के बारे में ज़्यादा जानकारी के लिए, कंपैरिज़न शॉपिंग सर्विस देखें. 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 खाते का आईडी देना होगा.

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

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

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

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

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

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

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