> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.googleAds.core.FindUserLists

- Component: `appmixer.googleAds.core.FindUserLists`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.googleAds 1.3.3](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.FindUserLists>

Finds up to 200 Google Ads user lists for a customer account with optional filtering.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Customer ID (`customerId`) | text | Google Ads customer ID, with or without dashes. |
| Login Customer ID (`loginCustomerId`) | text | The Google Ads Manager Account (MCC) ID. Required when accessing accounts managed through an MCC hierarchy. Format: 10-digit number, e.g. 1234567890. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#login-customer-id |
| GAQL Query (`searchQuery`) | textarea | Optional GAQL query override. Leave empty to use the default user list query. Example: WHERE user_list.name = 'My Audience' |
| Output Type (`outputType`) | select | Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file. |

## Output ports

### Port `out`

Variables are loaded dynamically from `/component/appmixer/googleAds/core/FindUserLists?outPort=out&ignoreAuth=true`.

### Port `notFound`

_No fields defined for this port._

## Full metadata (component.json)

```json
{
  "name": "appmixer.googleAds.core.FindUserLists",
  "description": "Finds up to 200 Google Ads user lists for a customer account with optional filtering.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:googleAds",
    "scope": [
      "https://www.googleapis.com/auth/adwords"
    ]
  },
  "quota": {
    "manager": "appmixer:googleAds",
    "resources": "requests"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "string"
          },
          "loginCustomerId": {
            "type": "string"
          },
          "searchQuery": {
            "type": "string"
          },
          "outputType": {
            "type": "string",
            "default": "array"
          }
        },
        "required": [
          "customerId"
        ]
      },
      "inspector": {
        "inputs": {
          "customerId": {
            "type": "text",
            "label": "Customer ID",
            "tooltip": "Google Ads customer ID, with or without dashes.",
            "index": 1
          },
          "loginCustomerId": {
            "type": "text",
            "label": "Login Customer ID",
            "tooltip": "The Google Ads Manager Account (MCC) ID. Required when accessing accounts managed through an MCC hierarchy. Format: 10-digit number, e.g. 1234567890. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#login-customer-id",
            "index": 2
          },
          "searchQuery": {
            "type": "textarea",
            "label": "GAQL Query",
            "tooltip": "Optional GAQL query override. Leave empty to use the default user list query. Example: WHERE user_list.name = 'My Audience'",
            "index": 3
          },
          "outputType": {
            "type": "select",
            "label": "Output Type",
            "index": 4,
            "defaultValue": "array",
            "tooltip": "Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file.",
            "options": [
              {
                "label": "First Item Only",
                "value": "first"
              },
              {
                "label": "All items at once",
                "value": "array"
              },
              {
                "label": "One item at a time",
                "value": "object"
              },
              {
                "label": "Store to CSV file",
                "value": "file"
              }
            ]
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "source": {
        "url": "/component/appmixer/googleAds/core/FindUserLists?outPort=out&ignoreAuth=true",
        "data": {
          "properties": {
            "generateOutputPortOptions": true
          },
          "messages": {
            "in/outputType": "inputs/in/outputType",
            "in/customerId": "any"
          }
        }
      }
    },
    {
      "name": "notFound"
    }
  ],
  "icon": "(data URI omitted)"
}
```
