> 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.GetUserList

- Component: `appmixer.googleAds.core.GetUserList`
- 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.GetUserList>

Gets a single Google Ads user list by ID.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Customer ID (`customerId`) | text | - |
| 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 |
| User List ID (`userListId`) | text | - |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Resource Name (`resourceName`) | string | - |
| ID (`id`) | string | - |
| Name (`name`) | string | - |
| Description (`description`) | string | - |
| Membership Status (`membershipStatus`) | string | - |
| Size for Search (`sizeForSearch`) | string | - |
| Size for Display (`sizeForDisplay`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.googleAds.core.GetUserList",
  "description": "Gets a single Google Ads user list by ID.",
  "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"
          },
          "userListId": {
            "type": "string"
          }
        },
        "required": [
          "customerId",
          "userListId"
        ]
      },
      "inspector": {
        "inputs": {
          "customerId": {
            "type": "text",
            "label": "Customer ID",
            "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
          },
          "userListId": {
            "type": "text",
            "label": "User List ID",
            "index": 3
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "example": {
          "resourceName": "customers/1234567890/userLists/9876543210",
          "id": "9876543210",
          "name": "High-Value Customers Q3",
          "description": "Customers who made purchases over $500 in Q3",
          "membershipStatus": "OPEN",
          "sizeForSearch": "15000",
          "sizeForDisplay": "12000"
        },
        "properties": {
          "resourceName": {
            "type": "string",
            "title": "Resource Name"
          },
          "id": {
            "type": "string",
            "title": "ID"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "membershipStatus": {
            "type": "string",
            "title": "Membership Status"
          },
          "sizeForSearch": {
            "type": "string",
            "title": "Size for Search"
          },
          "sizeForDisplay": {
            "type": "string",
            "title": "Size for Display"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
