# google-analytics.accounts.summaries

Accounts with their property ids, names and types

> Returns summaries of all accounts accessible by the caller.

Page: https://telipot.com/catalog/tasks/google-analytics.accounts.summaries · Markdown: https://telipot.com/catalog/tasks/google-analytics.accounts.summaries/md · JSON: https://telipot.com/catalog/tasks/google-analytics.accounts.summaries/json

| Field | Value |
| --- | --- |
| provider | [Google Analytics 4](https://telipot.com/catalog/providers/google-analytics) `google-analytics` |
| capability | [`analytics.accounts.summaries`](https://telipot.com/catalog/capabilities/analytics.accounts.summaries) |
| kind | utility |
| tier | core |
| price | Free (Free from the tool) |
| identity | Company account |
| auth | `oauth · OAuth 2.0 with PKCE` |
| scope | own_account |
| principal | organization |
| required_scopes | `analytics.readonly` |
| retention | standard |
| route | `GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/accountSummaries/list |

## Inspect first

No complete example input is recorded. Read the schema and field notes before building the call.

```bash
telipot inspect google-analytics.accounts.summaries
```

```bash
curl https://api.telipot.com/v1/tasks/google-analytics.accounts.summaries \
  -H "Authorization: Bearer $TELIPOT_TOKEN"
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `pageSize` | queryParams | integer | no | 1 to 200; default 50 | Accounts to return; a page may hold fewer even when more follow |
| `pageToken` | queryParams | string | no |  | The nextPageToken of the previous page |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "pageSize": {
      "type": "integer",
      "description": "Accounts to return; a page may hold fewer even when more follow",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    },
    "pageToken": {
      "type": "string",
      "description": "The nextPageToken of the previous page"
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "accountSummaries": {
      "type": "array",
      "description": "Absent when the connected account has no Analytics account",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "accountSummaries/<account id>"
          },
          "account": {
            "type": "string",
            "description": "accounts/<account id>"
          },
          "displayName": {
            "type": "string"
          },
          "propertySummaries": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "property": {
                  "type": "string",
                  "description": "properties/<property id>; the digits after the slash are the propertyId that google-analytics tasks take"
                },
                "displayName": {
                  "type": "string"
                },
                "propertyType": {
                  "type": "string",
                  "description": "PROPERTY_TYPE_ORDINARY, PROPERTY_TYPE_SUBPROPERTY or PROPERTY_TYPE_ROLLUP"
                },
                "parent": {
                  "type": "string",
                  "description": "The account or property the property sits under"
                }
              }
            }
          }
        }
      }
    },
    "nextPageToken": {
      "type": "string",
      "description": "Absent on the last page"
    }
  }
}
```

## Example response

From `examples/google-analytics.accounts.summaries.json`.

```json
{
  "accountSummaries": [
    {
      "name": "accountSummaries/100200300",
      "account": "accounts/100200300",
      "displayName": "Example",
      "propertySummaries": [
        {
          "property": "properties/123456789",
          "displayName": "example.com",
          "propertyType": "PROPERTY_TYPE_ORDINARY",
          "parent": "accounts/100200300"
        },
        {
          "property": "properties/987654321",
          "displayName": "example.com staging",
          "propertyType": "PROPERTY_TYPE_ORDINARY",
          "parent": "accounts/100200300"
        }
      ]
    }
  ]
}
```
