অ্যাডমিন SDK রিপোর্ট পরিষেবা

অ্যাডমিন SDK রিপোর্ট পরিষেবা আপনাকে Apps স্ক্রিপ্টে অ্যাডমিন SDK-এর রিপোর্ট API ব্যবহার করতে দেয়৷ এই API Google Workspace ডোমেনের প্রশাসকদের (রিসেলার সহ) তাদের ডোমেনের জন্য কাস্টম ব্যবহার প্রতিবেদন তৈরি করার ক্ষমতা দেয়।

রেফারেন্স

এই পরিষেবার বিস্তারিত তথ্যের জন্য, অ্যাডমিন SDK রিপোর্ট API-এর জন্য রেফারেন্স ডকুমেন্টেশন দেখুন। Apps স্ক্রিপ্টের সমস্ত উন্নত পরিষেবাগুলির মতো, অ্যাডমিন SDK রিপোর্ট পরিষেবাটি পাবলিক API হিসাবে একই বস্তু, পদ্ধতি এবং পরামিতিগুলি ব্যবহার করে৷ আরও তথ্যের জন্য, দেখুন কিভাবে পদ্ধতি স্বাক্ষর নির্ধারণ করা হয় ।

সমস্যাগুলি রিপোর্ট করতে এবং অন্যান্য সহায়তা পেতে, অ্যাডমিন SDK রিপোর্ট সমর্থন নির্দেশিকা দেখুন।

কোডের উদাহরণ

নীচের নমুনা কোডটি API-এর সংস্করণ 1 ব্যবহার করে।

লগইন কার্যকলাপ রিপোর্ট তৈরি করুন

এই নমুনা স্প্রেডশীট হিসাবে গত সপ্তাহের জন্য একটি লগইন কার্যকলাপ রিপোর্ট তৈরি করে। প্রতিবেদনে সময়, ব্যবহারকারী এবং লগইন ফলাফল অন্তর্ভুক্ত রয়েছে।

উন্নত/adminSDK.gs
/**
 * Generates a login activity report for the last week as a spreadsheet. The
 * report includes the time, user, and login result.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function generateLoginActivityReport() {
  const now = new Date();
  const oneWeekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
  const startTime = oneWeekAgo.toISOString();
  const endTime = now.toISOString();

  const rows = [];
  let pageToken;
  let page;
  do {
    page = AdminReports.Activities.list('all', 'login', {
      startTime: startTime,
      endTime: endTime,
      maxResults: 500,
      pageToken: pageToken
    });
    const items = page.items;
    if (items) {
      for (const item of items) {
        const row = [
          new Date(item.id.time),
          item.actor.email,
          item.events[0].name
        ];
        rows.push(row);
      }
    }
    pageToken = page.nextPageToken;
  } while (pageToken);

  if (rows.length === 0) {
    console.log('No results returned.');
    return;
  }
  const spreadsheet = SpreadsheetApp.create('Google Workspace Login Report');
  const sheet = spreadsheet.getActiveSheet();

  // Append the headers.
  const headers = ['Time', 'User', 'Login Result'];
  sheet.appendRow(headers);

  // Append the results.
  sheet.getRange(2, 1, rows.length, headers.length).setValues(rows);

  console.log('Report spreadsheet created: %s', spreadsheet.getUrl());
}

ব্যবহারকারীর ব্যবহারের প্রতিবেদন তৈরি করুন

এই নমুনাটি স্প্রেডশীট হিসাবে গত সপ্তাহে এই দিনের জন্য একটি ব্যবহারকারীর ব্যবহারের প্রতিবেদন তৈরি করে৷ প্রতিবেদনটিতে তারিখ, ব্যবহারকারী, শেষ লগইন সময়, প্রাপ্ত ইমেলের সংখ্যা এবং মালিকানাধীন ডক্সের সংখ্যা অন্তর্ভুক্ত রয়েছে।

উন্নত/adminSDK.gs
/**
 * Generates a user usage report for this day last week as a spreadsheet. The
 * report includes the date, user, last login time, number of emails received,
 * and number of drive files created.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/userUsageReport/get
 */
function generateUserUsageReport() {
  const today = new Date();
  const oneWeekAgo = new Date(today.getTime() - 7 * 24 * 60 * 60 * 1000);
  const timezone = Session.getScriptTimeZone();
  const date = Utilities.formatDate(oneWeekAgo, timezone, 'yyyy-MM-dd');

  const parameters = [
    'accounts:last_login_time',
    'gmail:num_emails_received',
    'drive:num_items_created'
  ];
  const rows = [];
  let pageToken;
  let page;
  do {
    page = AdminReports.UserUsageReport.get('all', date, {
      parameters: parameters.join(','),
      maxResults: 500,
      pageToken: pageToken
    });
    if (page.warnings) {
      for (const warning of page.warnings) {
        console.log(warning.message);
      }
    }
    const reports = page.usageReports;
    if (reports) {
      for (const report of reports) {
        const parameterValues = getParameterValues(report.parameters);
        const row = [
          report.date,
          report.entity.userEmail,
          parameterValues['accounts:last_login_time'],
          parameterValues['gmail:num_emails_received'],
          parameterValues['drive:num_items_created']
        ];
        rows.push(row);
      }
    }
    pageToken = page.nextPageToken;
  } while (pageToken);

  if (rows.length === 0) {
    console.log('No results returned.');
    return;
  }
  const spreadsheet = SpreadsheetApp.create('Google Workspace User Usage Report');
  const sheet = spreadsheet.getActiveSheet();

  // Append the headers.
  const headers = ['Date', 'User', 'Last Login', 'Num Emails Received',
    'Num Drive Files Created'];
  sheet.appendRow(headers);

  // Append the results.
  sheet.getRange(2, 1, rows.length, headers.length).setValues(rows);

  console.log('Report spreadsheet created: %s', spreadsheet.getUrl());
}

/**
 * Gets a map of parameter names to values from an array of parameter objects.
 * @param {Array} parameters An array of parameter objects.
 * @return {Object} A map from parameter names to their values.
 */
function getParameterValues(parameters) {
  return parameters.reduce((result, parameter) => {
    const name = parameter.name;
    let value;
    if (parameter.intValue !== undefined) {
      value = parameter.intValue;
    } else if (parameter.stringValue !== undefined) {
      value = parameter.stringValue;
    } else if (parameter.datetimeValue !== undefined) {
      value = new Date(parameter.datetimeValue);
    } else if (parameter.boolValue !== undefined) {
      value = parameter.boolValue;
    }
    result[name] = value;
    return result;
  }, {});
}