दिए गए FirebaseProject
को किसी मौजूदा Google Analytics खाते से लिंक करता है.
इस कॉल का इस्तेमाल करके, इनमें से कोई एक काम किया जा सकता है:
- किसी खाते में नई Google Analytics प्रॉपर्टी का प्रावधान करने के लिए,
analyticsAccountId
तय करें और नई प्रॉपर्टी कोFirebaseProject
से जोड़ें. - प्रॉपर्टी को
FirebaseProject
के साथ असोसिएट करने के लिए, कोई मौजूदाanalyticsPropertyId
बताएं.
ध्यान दें कि projects.addGoogleAnalytics
को कॉल करने पर:
- पहली जांच में यह तय किया जाता है कि Google Analytics प्रॉपर्टी की कोई मौजूदा डेटा स्ट्रीम,
FirebaseProject
में किसी मौजूदा Firebase ऐप्लिकेशन से मेल खाती है या नहीं. डेटा स्ट्रीम से जुड़ेpackageName
याbundleId
के आधार पर ऐसा किया जाता है. इसके बाद, ज़रूरत के मुताबिक डेटा स्ट्रीम और ऐप्लिकेशन लिंक कर दिए जाते हैं. ध्यान दें कि अपने-आप लिंक करने की यह सुविधा सिर्फ़AndroidApps
औरIosApps
पर लागू होती है. - अगर Firebase ऐप्लिकेशन के लिए कोई संबंधित डेटा स्ट्रीम नहीं मिलती है, तो Google Analytics प्रॉपर्टी में हर Firebase ऐप्लिकेशन के लिए नई डेटा स्ट्रीम का प्रावधान कर दिया जाता है. ध्यान दें कि वेब ऐप्लिकेशन के लिए, नई डेटा स्ट्रीम का हमेशा प्रावधान किया जाता है. भले ही, वह पहले Analytics प्रॉपर्टी में किसी डेटा स्ट्रीम से जुड़ी हो.
Analytics दस्तावेज़ में, Google Analytics खातों के क्रम और स्ट्रक्चर के बारे में ज़्यादा जानें.
इस कॉल का नतीजा Operation
है. operations.get
को कॉल करके प्रावधान की प्रोसेस ट्रैक करने के लिए, Operation
को पोल करें. ऐसा तब तक करें, जब तक done
, true
न हो जाए. जब done
, true
होता है, तो Operation
लागू हो गया है या नहीं हो सका. अगर Operation
सफल हो गया है, तो उसका response
AnalyticsDetails
पर सेट हो जाता है; अगर Operation
विफल हो जाता है, तो उसका error
google.rpc.Status
पर सेट हो जाता है.
projects.addGoogleAnalytics
को कॉल करने के लिए, प्रोजेक्ट का सदस्य मौजूदा FirebaseProject
का मालिक होना चाहिए. साथ ही, उसके पास Google Analytics खाते के लिए Edit
अनुमति भी होनी चाहिए.
अगर FirebaseProject
में Google Analytics पहले से चालू है और आपने projects.addGoogleAnalytics
को कॉल करने के लिए कोई ऐसी analyticsPropertyId
इस्तेमाल की है जो मौजूदा समय में जुड़ी हुई प्रॉपर्टी से अलग है, तो कॉल शुरू नहीं होगा. ऐसा हो सकता है कि Firebase कंसोल में Analytics पहले से ही चालू हो या projects.addFirebase
को किए गए कॉल में timeZone
और regionCode
की जानकारी देकर.
एचटीटीपी अनुरोध
POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
किसी मौजूदा Google Analytics खाते से लिंक करने के लिए,
PROJECT_IDENTIFIER वैल्यू के बारे में जानकारी के लिए, |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड analytics_resource . अनुरोध के मुख्य हिस्से में, Google Analytics का सिर्फ़ एक संसाधन इस्तेमाल किया जा सकता है.
analytics_resource इनमें से सिर्फ़ एक हो सकता है: |
|
analyticsAccountId |
उस मौजूदा Google Analytics खाते का आईडी जिसे इस फ़ील्ड की जानकारी देने से, आपके Google Analytics खाते में एक नई Google Analytics प्रॉपर्टी का प्रावधान हो जाएगा. साथ ही, नई प्रॉपर्टी |
analyticsPropertyId |
उस मौजूदा Google Analytics प्रॉपर्टी का आईडी जिसे आपको |
जवाब का लेख
कामयाब होने पर, जवाब के मुख्य हिस्से में Operation
का एक इंस्टेंस शामिल होता है.
अनुमति की संभावना
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/firebase
ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.