वे खाते सेट करना जिन्हें पार्टनर कंट्रोल करता है – एपीआई डेवलपर गाइड

चेतावनी: प्रॉविज़निंग एपीआई, फ़िलहाल सिर्फ़ न्योता मिलने पर उपलब्ध है. Google Analytics एडमिन एपीआई V1 की खाता मैनेज करने की सुविधा का इस्तेमाल करें. यह सुविधा सार्वजनिक तौर पर उपलब्ध है और तुरंत इस्तेमाल किए जाने के लिए तैयार है.

शुरुआती जानकारी

createAccountTree, प्रॉविज़निंग एपीआई का हिस्सा है. इसका इस्तेमाल, बड़े पैमाने पर नए Google Analytics खाते बनाने के लिए किया जा सकता है. createAccountTicket के उलट, खाता बनाने के लिए createAccountTree को असली उपयोगकर्ता के इंटरैक्शन की ज़रूरत नहीं होती. यह प्रोसेस पूरी तरह से ऑटोमेटेड होती है. यह तब काम आता है, जब आपको एक ऐसे Analytics खाते का प्रावधान करना होता है जिसे ग्राहक की ओर से कंट्रोल किया जाता है और जहां अपने ग्राहक को उस डेटा का पसंद के मुताबिक व्यू उपलब्ध कराया जाता है.

यह एपीआई उन पार्टनर के लिए रिज़र्व है जो अपने उपयोगकर्ताओं की वेबसाइटों या वेब प्रॉपर्टी को कंट्रोल करते हैं. अगर आपके उपयोगकर्ता अपनी वेबसाइटों या वेब प्रॉपर्टी को कंट्रोल करते हैं, तो आपको उपयोगकर्ता के कंट्रोल वाले Analytics खाते बनाने चाहिए.

शुरू करने से पहले

सभी Google Analytics एपीआई को एक ही तरह से ऐक्सेस किया जाता है. प्रॉविज़निंग एपीआई शुरू करने से पहले, आपको ये काम करने चाहिए:

• एपीआई के साथ काम करने वाली प्रोग्रामिंग भाषा की खास क्लाइंट लाइब्रेरी की पूरी सूची देखने के लिए, क्लाइंट लाइब्रेरी पेज पढ़ें.
• एपीआई इंटरफ़ेस और क्लाइंट लाइब्रेरी के बिना डेटा ऐक्सेस करने का तरीका जानने के लिए, रेफ़रंस गाइड पढ़ें.

प्रॉविज़निंग एपीआई को ऐक्सेस करने के लिए, हर क्लाइंट लाइब्रेरी एक Analytics सेवा ऑब्जेक्ट उपलब्ध कराती है. सेवा ऑब्जेक्ट बनाने के लिए, आम तौर पर आपको नीचे दिए गए चरणों का पालन करना पड़ता है:

1. Google API (एपीआई) कंसोल में अपना ऐप्लिकेशन रजिस्टर करें.
2. नया Google Analytics खाता बनाने की अनुमति दें.
3. Analytics सेवा ऑब्जेक्ट बनाएं.

अगर आपने इन चरणों को पूरा नहीं किया है, तो कृपया रुकें और नमस्ते Google Analytics API ट्यूटोरियल पढ़ें. इस ट्यूटोरियल में, Google Analytics API ऐप्लिकेशन बनाने के शुरुआती चरणों की जानकारी दी गई है. यह चरण पूरा करने के बाद, आपको यह पता चल जाएगा कि असल काम करने के लिए, Google Analytics API को कैसे ऐक्सेस किया जा सकता है.

टेंप्लेट खाता

इस एपीआई का इस्तेमाल करने की अनुमति मिलने के तहत, आपको एक नया Google Analytics खाता उपलब्ध कराना होगा. यह खाता इस एपीआई के टेंप्लेट खाते के तौर पर काम करता है. नए खाते बनाने पर, उनमें टेंप्लेट खाते से कई सेटिंग इनहेरिट की जाती हैं. इनमें, सेवा की शर्तें स्वीकार करने वाला खाता, संगठन, और कई डेटा शेयर करने की सेटिंग शामिल हैं. टेंप्लेट खाते के बारे में ज़्यादा जानकारी के लिए, createAccountTree रेफ़रंस देखें. इसमें, इनहेरिट किए गए सभी डेटा की सूची भी शामिल है.

खाते का प्रावधान करना

नए Google Analytics खाते का प्रावधान करने के लिए, createAccountTree एपीआई एंडपॉइंट को अनुरोध करें. आपको प्रावधान से जुड़ी इन जानकारी की ज़रूरत होगी:

• खाता फ़ील्ड
  • खाते के लिए accountName.
• वेब प्रॉपर्टी फ़ील्ड
  • प्रॉपर्टी के लिए एक webpropertyName.
  • एक websiteUrl. यह यूआरएल, इस Analytics खाते की उपयोगकर्ता प्रॉपर्टी से जुड़ा होना चाहिए.
• फ़ील्ड देखें
  • व्यू के लिए profileName.
  • व्यू के लिए timezone.

ध्यान दें: "प्रोफ़ाइल", Analytics व्यू का एक लेगसी नाम है. एपीआई में पुराने नाम को ही रखा जाता है, ताकि एपीआई बेहतर तरीके से काम कर सके.

जानकारी मिल जाने के बाद, एपीआई एंडपॉइंट पर पुष्टि किया गया कॉल करें:

POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
    "accountName": "Analytics Account",
    "webpropertyName": "Default Property",
    "profileName": "Default View",
    "timezone": "America/Los_Angeles",
    "websiteUrl": "www.example-pet-store.com",
}

अगर अनुरोध स्वीकार किया जाता है, तो एपीआई नए बनाए गए खाते, वेब प्रॉपर्टी, और व्यू की जानकारी के साथ जवाब देगा:

{
    "account": {
        "id": "999999999",
        "name": "Analytics Account",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "webproperty": {
        "id": "UA-999999999-1",
        "name": "Default Property",
        "websiteUrl": "www.example-pet-store.com",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "profile": {
        "id": "999999999",
        "name": "Default View",
        "timezone": "America/Los_Angeles",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    ...
}

ध्यान दें: कम शब्दों में जानकारी देने के लिए, रिस्पॉन्स के कुछ फ़ील्ड को हटाया गया है. जवाब के स्ट्रक्चर की पूरी जानकारी के लिए, जवाब का रेफ़रंस देखें.

खाते का मालिकाना हक और मैनेजमेंट

बनाए गए Google Analytics खाते का मालिकाना हक उस उपयोगकर्ता खाते के पास होगा जिसने OAuth के ज़रिए जवाब देने की अनुमति दी है. इस वजह से, हमारा सुझाव है कि आपका संगठन Analytics खाते को मैनेज करने के लिए, किसी व्यक्तिगत उपयोगकर्ता खाते के बजाय सेवा खाते का इस्तेमाल करें.

ध्यान दें: Analytics खाते, जो खास तौर पर सेवा खातों से मैनेज होते हैं, वे Analytics यूज़र इंटरफ़ेस (यूआई) में कहीं भी नहीं दिखेंगे. हालांकि, डेटा को अब भी रिपोर्टिंग और क्वेरी एपीआई के ज़रिए ऐक्सेस किया जा सकता है, लेकिन सिर्फ़ खाते से जुड़े उपयोगकर्ता ही इसे Analytics यूज़र इंटरफ़ेस (यूआई) में देख सकते हैं. खाते का उपयोगकर्ता ऐक्सेस मैनेज करने के लिए, Management API का इस्तेमाल किया जा सकता है.

खाता बनाने के बाद, उसे Management API के साथ कॉन्फ़िगर किया जा सकता है. नए खाते को इस्तेमाल करने के कुछ सामान्य काम यहां दिए गए हैं:

• Google Ads खाता लिंक करना
• उपयोगकर्ता खाते जोड़ना या मैनेज करना
• व्यू, सेगमेंट, लक्ष्य वगैरह जोड़ना

खाते से जुड़ी संबंधों के बारे में जानकारी

सभी Google API की तरह ही, अनुरोध की अनुमति पाने के लिए, शुरुआत में Google Cloud प्रोजेक्ट की ज़रूरत होती है. जैसा कि OAuth 2.0 दस्तावेज़ में बताया गया है, इसी खाते से एपीआई अनुरोधों के लिए अपने क्रेडेंशियल मैनेज किए जा सकेंगे. हालांकि, बनाया गया Google Analytics खाता, Cloud प्रोजेक्ट या इसके खातों को मैनेज करने वाले किसी भी तरीके से सीधे तौर पर नहीं जुड़ा है. यह सिर्फ़ उस उपयोगकर्ता या सेवा खाते से जुड़ा है जिसने अनुरोध को अनुमति दी है. अगर आपको Analytics खाते के लिए खाते का ऐक्सेस कॉन्फ़िगर करना है, तो Management API का इस्तेमाल किया जा सकता है.

इसी विषय से जुड़े लिंक

• Management API
• सेवा खाते
• createAccountTree रेफ़रंस