Analytics डेटा सेवा

Analytics Data API v1 का इस्तेमाल करने के लिए, Apps Script का इस्तेमाल करना.

Analytics Data सेवा की मदद से, Google Analytics Data API v1 का इस्तेमाल Google Apps Script में किया जा सकता है. इस एपीआई की मदद से, Google Analytics के उपयोगकर्ता प्रोग्राम के ज़रिए Google Analytics 4 (GA4) की रिपोर्ट का डेटा ऐक्सेस कर सकते हैं.

यह एक अडवांस सेवा है. इसका इस्तेमाल करने से पहले, इसे चालू करना ज़रूरी है.

संदर्भ

इस सेवा के बारे में ज़्यादा जानकारी पाने के लिए, Google Analytics Data API v1 के रेफ़रंस से जुड़ा दस्तावेज़ देखें.

Apps Script में मौजूद सभी अडवांस सेवाओं की तरह, AnalyticsData सेवा भी सार्वजनिक एपीआई के ऑब्जेक्ट, तरीकों, और पैरामीटर का इस्तेमाल करती है. ज़्यादा जानकारी के लिए, तरीकों के सिग्नेचर कैसे तय किए जाते हैं लेख पढ़ें.

समस्याओं की शिकायत करने और अन्य सहायता पाने के लिए, Google Analytics Data API v1 का सहायता पेज देखें.

नमूना कोड

रिपोर्ट चलाना

इस नमूने में, शहर के हिसाब से सक्रिय उपयोगकर्ताओं की संख्या पाने के लिए रिपोर्ट चलाई जाती है. साथ ही, नतीजों को नई स्प्रेडशीट में सेव किया जाता है.

advanced/analyticsData.gs
/**
 * Runs a report of a Google Analytics 4 property ID. Creates a sheet with the
 * report.
 */
function runReport() {
  /**
   * TODO(developer): Uncomment this variable and replace with your
   *   Google Analytics 4 property ID before running the sample.
   */
  const propertyId = "YOUR-GA4-PROPERTY-ID";

  try {
    const metric = AnalyticsData.newMetric();
    metric.name = "activeUsers";

    const dimension = AnalyticsData.newDimension();
    dimension.name = "city";

    const dateRange = AnalyticsData.newDateRange();
    dateRange.startDate = "2020-03-31";
    dateRange.endDate = "today";

    const request = AnalyticsData.newRunReportRequest();
    request.dimensions = [dimension];
    request.metrics = [metric];
    request.dateRanges = dateRange;

    const report = AnalyticsData.Properties.runReport(
      request,
      `properties/${propertyId}`,
    );
    if (!report.rows) {
      console.log("No rows returned.");
      return;
    }

    const spreadsheet = SpreadsheetApp.create("Google Analytics Report");
    const sheet = spreadsheet.getActiveSheet();

    // Append the headers.
    const dimensionHeaders = report.dimensionHeaders.map((dimensionHeader) => {
      return dimensionHeader.name;
    });
    const metricHeaders = report.metricHeaders.map((metricHeader) => {
      return metricHeader.name;
    });
    const headers = [...dimensionHeaders, ...metricHeaders];

    sheet.appendRow(headers);

    // Append the results.
    const rows = report.rows.map((row) => {
      const dimensionValues = row.dimensionValues.map((dimensionValue) => {
        return dimensionValue.value;
      });
      const metricValues = row.metricValues.map((metricValues) => {
        return metricValues.value;
      });
      return [...dimensionValues, ...metricValues];
    });

    sheet.getRange(2, 1, report.rows.length, headers.length).setValues(rows);

    console.log("Report spreadsheet created: %s", spreadsheet.getUrl());
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log("Failed with error: %s", e.error);
  }
}