npm package: @maxim_mazurok/gapi.client.admin-reports_v1
Description: TypeScript typings for Admin SDK API reports_v1
Author: Maxim Mazurok
Latest version: 0.4.20260407

# TypeScript typings for Admin SDK API reports_v1

Admin SDK lets administrators of enterprise domains to view and manage resources like user, groups etc. It also provides audit and usage reports of domain.
For detailed description please check [documentation](https://developers.google.com/workspace/admin/).

## Installing

Install typings for Admin SDK API:

```
npm install @types/gapi.client.admin-reports_v1 --save-dev
```

## TypeScript 6.0+

TypeScript 6.0 changed `types` to default to `[]`. You must now explicitly list type packages in `tsconfig.json`:

```json
{
  "compilerOptions": {
    "types": [
      "gapi",
      "gapi.auth2",
      "gapi.client",
      "gapi.client.admin-reports_v1"
    ]
  }
}
```

## Usage

You need to initialize Google API client in your code:

```typescript
gapi.load('client', () => {
  // now we can use gapi.client
  // ...
});
```

Then load api client wrapper:

```typescript
gapi.client.load(
  'https://admin.googleapis.com/$discovery/rest?version=reports_v1',
  () => {
    // now we can use:
    // gapi.client.admin
    // gapi.client.reports
  },
);
```

```typescript
// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
gapi.client.load('admin', 'reports_v1', () => {
  // now we can use:
  // gapi.client.admin
  // gapi.client.reports
});
```

Don't forget to authenticate your client before sending any request to resources:

```typescript
// declare client_id registered in Google Developers Console
var client_id = '',
  scope = [
    // View audit reports for your Google Workspace domain
    'https://www.googleapis.com/auth/admin.reports.audit.readonly',

    // View usage reports for your Google Workspace domain
    'https://www.googleapis.com/auth/admin.reports.usage.readonly',
  ],
  immediate = true;
// ...

gapi.auth.authorize(
  {client_id: client_id, scope: scope, immediate: immediate},
  authResult => {
    if (authResult && !authResult.error) {
      /* handle successful authorization */
    } else {
      /* handle authorization error */
    }
  },
);
```

After that you can use Admin SDK API resources: <!-- TODO: make this work for multiple namespaces -->

```typescript
/*
Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides. 
*/
await gapi.client.reports.activities.list({
  applicationName: 'applicationName',
  userKey: 'userKey',
});

/*
Start receiving notifications for account activities. For more information, see Receiving Push Notifications.
*/
await gapi.client.reports.activities.watch({
  applicationName: 'applicationName',
  userKey: 'userKey',
});

/*
Stop watching resources through this channel.
*/
await gapi.client.admin.channels.stop({});

/*
Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides. 
*/
await gapi.client.reports.customerUsageReports.get({date: 'date'});

/*
Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.
*/
await gapi.client.reports.entityUsageReports.get({
  date: 'date',
  entityKey: 'entityKey',
  entityType: 'entityType',
});

/*
Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.
*/
await gapi.client.reports.userUsageReport.get({
  date: 'date',
  userKey: 'userKey',
});
```

For provenance information see [Provenance section on NPM](https://www.npmjs.com/package/@maxim_mazurok/gapi.client.admin-reports_v1#Provenance:~:text=none-,Provenance,-Built%20and%20signed)