# google-analytics.properties.streams.list

Data streams of a property with measurement ids and domains

> Lists DataStreams on a property.

Page: https://telipot.com/catalog/tasks/google-analytics.properties.streams.list · Markdown: https://telipot.com/catalog/tasks/google-analytics.properties.streams.list/md · JSON: https://telipot.com/catalog/tasks/google-analytics.properties.streams.list/json

| Field | Value |
| --- | --- |
| provider | [Google Analytics 4](https://telipot.com/catalog/providers/google-analytics) `google-analytics` |
| capability | [`analytics.properties.streams.list`](https://telipot.com/catalog/capabilities/analytics.properties.streams.list) |
| kind | data |
| 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/properties/{propertyId}/dataStreams` |
| 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/properties.dataStreams/list |

## Preview the price · nothing runs

```bash
telipot run google-analytics.properties.streams.list \
  --input-json '{"propertyId":"123456789"}' \
  --quote
```

## Run it

```bash
telipot run google-analytics.properties.streams.list \
  --input-json '{"propertyId":"123456789"}'
```

```bash
curl https://api.telipot.com/v1/tasks/google-analytics.properties.streams.list/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"propertyId":"123456789"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `propertyId` | pathParams | string | yes |  | The numeric id of a GA4 property, as google-analytics.accounts.summaries returns it after properties/ |
| `pageSize` | queryParams | integer | no | 1 to 200; default 50 | Streams 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": {
    "propertyId": {
      "type": "string",
      "description": "The numeric id of a GA4 property, as google-analytics.accounts.summaries returns it after properties/",
      "examples": [
        "123456789"
      ]
    },
    "pageSize": {
      "type": "integer",
      "description": "Streams 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"
    }
  },
  "required": [
    "propertyId"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "dataStreams": {
      "type": "array",
      "description": "Absent when the property has no stream",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "properties/<property id>/dataStreams/<stream id>"
          },
          "type": {
            "type": "string",
            "description": "WEB_DATA_STREAM, ANDROID_APP_DATA_STREAM or IOS_APP_DATA_STREAM"
          },
          "displayName": {
            "type": "string"
          },
          "createTime": {
            "type": "string"
          },
          "updateTime": {
            "type": "string"
          },
          "webStreamData": {
            "type": "object",
            "description": "Present for a web stream",
            "properties": {
              "measurementId": {
                "type": "string",
                "description": "The G- id a page's tag reports to"
              },
              "defaultUri": {
                "type": "string",
                "description": "The domain being measured"
              },
              "firebaseAppId": {
                "type": "string"
              }
            }
          },
          "androidAppStreamData": {
            "type": "object",
            "description": "Present for an Android app stream",
            "properties": {
              "packageName": {
                "type": "string"
              },
              "firebaseAppId": {
                "type": "string"
              }
            }
          },
          "iosAppStreamData": {
            "type": "object",
            "description": "Present for an iOS app stream",
            "properties": {
              "bundleId": {
                "type": "string"
              },
              "firebaseAppId": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "nextPageToken": {
      "type": "string",
      "description": "Absent on the last page"
    }
  }
}
```

## Example response

From `examples/google-analytics.properties.streams.list.json`.

```json
{
  "dataStreams": [
    {
      "name": "properties/123456789/dataStreams/9876543210",
      "type": "WEB_DATA_STREAM",
      "displayName": "example.com",
      "createTime": "2024-01-15T10:25:00.000Z",
      "updateTime": "2024-01-15T10:25:00.000Z",
      "webStreamData": {
        "measurementId": "G-EXAMPLE123",
        "defaultUri": "https://www.example.com"
      }
    }
  ]
}
```
