कमांड लाइन का इस्तेमाल करके, एपीआई क्विकस्टार्ट

इस पेज पर कमांड लाइन का इस्तेमाल करके, Google Analytics Data API v1 का इस्तेमाल शुरू करने का तरीका बताया गया है.

पहला चरण. एपीआई चालू करें

नया Cloud Platform प्रोजेक्ट बनाने के लिए इस बटन पर क्लिक करें, Google Analytics Data API v1 अपने-आप चालू हो जाए, और इस ट्यूटोरियल के लिए ज़रूरी OAuth2 क्रेडेंशियल बनाएं:

Google Analytics Data API v1 चालू करना

आपको OAuth2 क्रेडेंशियल कॉन्फ़िगरेशन डायलॉग पर अपने-आप रीडायरेक्ट कर दिया जाएगा. "आपको कहां से कॉल करना है?" पूछे जाने पर, "डेस्कटॉप" चुनें.

डायलॉग बॉक्स में, क्लाइंट कॉन्फ़िगरेशन डाउनलोड करें पर क्लिक करें और फ़ाइल को credentials.json अपनी वर्क डायरेक्ट्री में सेव करें.

इसके अलावा, किसी मौजूदा प्रोजेक्ट में मैन्युअल तरीके से OAuth2 क्रेडेंशियल बनाने के लिए, यह तरीका अपनाया जा सकता है.

दूसरा चरण. Cloud SDK को इंस्टॉल और शुरू करना

आपके पास अपनी डेवलपमेंट मशीन पर gcloud कमांड लाइन टूल इंस्टॉल होना चाहिए.

तीसरा चरण: एपीआई कॉल करना

अब Google Analytics 4 प्रॉपर्टी के लिए क्वेरी करने के लिए, Google Analytics Data API का इस्तेमाल किया जा सकता है.

रिपोर्टिंग इकाई चुनें

इस ट्यूटोरियल में, हम एपीआई अनुरोधों में इस्तेमाल की जाने वाली प्रॉपर्टी आईडी को स्टोर करने के लिए, एनवायरमेंट वैरिएबल GA4_PROPERTY_ID का इस्तेमाल करेंगे.

GA4_PROPERTY_ID वैरिएबल सेट करने के लिए, अपनी कमांड लाइन में यह डालें:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

[YOUR-GA4-PROPERTY-ID] को अपने Google Analytics 4 प्रॉपर्टी आइडेंटिफ़ायर से बदलें. उदाहरण के लिए:

export GA4_PROPERTY_ID=1234567890

अनुरोध वाला JSON फ़ॉर्मैट

नीचे दी गई request.json फ़ाइल में सामान्य रिपोर्ट बनाने का तरीका बताया गया है.

आगे दिए गए टेक्स्ट के साथ JSON अनुरोध फ़ाइल बनाएं और उसे अपनी वर्क डायरेक्ट्री में request.json सादे टेक्स्ट वाली फ़ाइल के तौर पर सेव करें:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

प्रमाणीकृत करें

इस उदाहरण में उपयोगकर्ता के क्रेडेंशियल पाने के लिए, नीचे दिया गया निर्देश चलाएं और पहले चरण में डाउनलोड की गई क्रेडेंशियल JSON फ़ाइल के पाथ का इस्तेमाल करें:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

नई ब्राउज़र विंडो में, OAuth उपयोगकर्ता की सहमति वाला डायलॉग बॉक्स खुलेगा.

अनुरोध भेजें

Google Analytics Data API को अनुरोध भेजने के लिए, curl और request.json के मुख्य कॉन्टेंट का इस्तेमाल करें. अपनी कमांड लाइन में यह जानकारी डालें:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json

पुष्टि करने वाला टोकन पाने के लिए, curl कमांड, gcloud auth application-default print-access-token कमांड का इस्तेमाल करता है.

ध्यान दें कि कर्ल करने के लिए फ़ाइल का नाम पास करने के लिए, -d विकल्प ("डेटा" के लिए) का इस्तेमाल करें और फ़ाइल नाम से पहले @ का निशान लगाएं. यह फ़ाइल उसी डायरेक्ट्री में होनी चाहिए जिसमें curl कमांड का इस्तेमाल किया जाता है.

बधाई हो! आपने Google Analytics Data API को अपना पहला अनुरोध भेज दिया है.