Google Ads API में खाते के टाइप

इस दस्तावेज़ में, Google Ads API में खातों के बारे में बताने के लिए इस्तेमाल किए जाने वाले अलग-अलग शब्दों के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि वे एक-दूसरे से कैसे जुड़े हैं.

खास जानकारी

Google Ads API, खातों के बारे में बताने के लिए कई शब्दों का इस्तेमाल करता है. इससे कभी-कभी भ्रम की स्थिति पैदा हो सकती है. खातों को मैनेज करने और एपीआई से मिलने वाली जानकारी को समझने के लिए, इन अंतरों को समझना ज़रूरी है.

खाता प्रकार

Google Ads API का इस्तेमाल करते समय, आपको अलग-अलग तरह के खाते दिखेंगे. यहां दी गई परिभाषाओं से, आपको इन खातों के बारे में जानकारी मिलेगी.

मैनेजर खाता

मैनेजर खाता एक प्राइमरी खाता होता है. इसका इस्तेमाल, कई Google Ads खातों को मैनेज करने के लिए किया जाता है.

  • पुराना नाम: इसे पहले "एमसीसी" (मेरा ग्राहक केंद्र) कहा जाता था. आपको यह शब्द अब भी लेगसी दस्तावेज़ों या चर्चाओं में दिख सकता है.
  • मकसद: मैनेजर खाते का इस्तेमाल तब करें, जब आपको एक ही हैरारकी से कई खातों को लिंक और मैनेज करना हो.
  • एपीआई रिप्रज़ेंटेशन: इसकी पहचान Customer संसाधन से की जाती है, जहां customer.manager, true है.

विज्ञापन देने वाले का (विज्ञापन दिखाने वाला) खाता

विज्ञापन देने वाले का खाता (या विज्ञापन दिखाने वाला खाता) एक ऐसा Google Ads खाता होता है जिससे विज्ञापन कैंपेन चलाए जाते हैं.

  • मकसद: यहां कैंपेन, विज्ञापन ग्रुप, ऐसेट ग्रुप, और विज्ञापन बनाए और दिखाए जाते हैं.
  • एपीआई रिप्रज़ेंटेशन: इसकी पहचान Customer संसाधन से की जाती है, जहां customer.manager, false है.

क्लाइंट खाता

क्लाइंट खाता, विज्ञापन देने वाले व्यक्ति या कंपनी का खाता या कोई दूसरा मैनेजर खाता होता है. इसे क्रम में सबसे ऊपर मौजूद मैनेजर खाते से लिंक किया जाता है और उसी से मैनेज किया जाता है.

  • कॉन्टेक्स्ट: "क्लाइंट" शब्द का मतलब, क्रम में मौजूद संबंध से है. इसे मैनेजर मैनेज करता है. यह ज़रूरी नहीं है कि कारोबार के लिहाज़ से यह "क्लाइंट" हो.
  • एपीआई रिप्रज़ेंटेशन: मैनेजर खाते की हैरारकी में मौजूद खातों की जांच करने के लिए, CustomerClient को क्वेरी करें. साथ ही, मैनेजर और क्लाइंट खातों के बीच के लिंक मैनेज करने के लिए, CustomerClientLink का इस्तेमाल करें.

ग्राहक

एपीआई के संदर्भ में, ग्राहक एक ऐसा संसाधन है जो किसी भी Google Ads खाते को दिखाता है. भले ही, वह मैनेजर खाता हो या विज्ञापन देने वाले का खाता.

  • रिप्रज़ेंटेशन: सभी खातों को Customer रिसॉर्स से रिप्रज़ेंट किया जाता है. इसकी पहचान customer_id से की जाती है.
  • भूमिका: खाते का टाइप (मैनेजर या विज्ञापन दिखाने वाला खाता), किसी खास संसाधन पर निर्भर करता है.

परीक्षण खाता

टेस्ट खाते, विज्ञापन देने वाले के खास खाते होते हैं. इन्हें एपीआई इंटिग्रेशन की जांच करने के लिए, खास तौर पर बनाए गए टेस्ट मैनेजर खाते के तहत व्यवस्थित किया जाता है. टेस्ट मैनेजर खाते और उसके तहत आने वाले टेस्ट ऐडवर्टाइज़र खातों, दोनों के customer.test_account फ़ील्ड को true पर सेट किया गया है. टेस्ट खातों को प्रोडक्शन मैनेजर खाते में नहीं बनाया जा सकता.

  • मकसद: टेस्ट खातों की मदद से, एपीआई कॉल को टेस्ट किया जा सकता है. इसके लिए, आपको लाइव विज्ञापन दिखाने या पैसे खर्च करने की ज़रूरत नहीं होती. इनमें लाइव विज्ञापन नहीं दिखाए जाते.
  • एपीआई रिप्रज़ेंटेशन: इसकी पहचान Customer रिसॉर्स से की जाती है, जहां customer.test_account, true है. साथ ही, customer.manager, टेस्ट मैनेजर खाते को टेस्ट ऐडवर्टाइज़र खाते से अलग करता है.

हैरारकी का उदाहरण

आम तौर पर, हैरारकी इस तरह दिखती है:

  • मैनेजर खाता A (टॉप लेवल)
    • क्लाइंट खाता B (विज्ञापन देने वाले का खाता)
    • क्लाइंट खाता C (कोई दूसरा मैनेजर खाता)
      • क्लाइंट खाता D (विज्ञापन देने वाले का खाता)

इस उदाहरण में:

  • खाता A एक मैनेजर खाता है.
  • खाते B, C, और D, अपने पैरंट खातों के लिए क्लाइंट खाते हैं.
  • खाते B और D, विज्ञापन देने वाले खाते (विज्ञापन दिखाने वाले खाते) हैं.
  • खाता C, क्लाइंट खाता (A के लिए) और मैनेजर खाता (D के लिए), दोनों है.