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

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

Updates properties of an existing Customer Match user list (name, description, membership life span, integration code, etc.).

## 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 | Numeric ID of the Customer Match user list. Use either User List ID or User List Resource Name. |
| User List Resource Name (`userListResourceName`) | text | Full resource name, e.g. customers/123/userLists/456. Use either this or User List ID. |
| Name (`name`) | text | New name for the user list. Must be unique per customer. |
| Description (`description`) | textarea | New description for the user list. |
| Membership Life Span (days) (`membershipLifeSpan`) | number | Number of days a user's cookie stays on the list (0-540, or 10000 for no expiration for CRM lists). |
| Integration Code (`integrationCode`) | text | ID from external system for correlation with Google Ads. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Resource Name (`resourceName`) | string | - |
| ID (`id`) | string | - |
| Name (`name`) | string | - |
| Description (`description`) | string | - |
| Type (`type`) | string | - |
| Membership Status (`membershipStatus`) | string | - |
| Membership Life Span (`membershipLifeSpan`) | string | - |
| Integration Code (`integrationCode`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.googleAds.core.UpdateUserList",
  "description": "Updates properties of an existing Customer Match user list (name, description, membership life span, integration code, etc.).",
  "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"
          },
          "userListResourceName": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "membershipLifeSpan": {
            "type": "integer"
          },
          "integrationCode": {
            "type": "string"
          }
        },
        "required": [
          "customerId"
        ]
      },
      "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",
            "tooltip": "Numeric ID of the Customer Match user list. Use either User List ID or User List Resource Name.",
            "index": 3
          },
          "userListResourceName": {
            "type": "text",
            "label": "User List Resource Name",
            "tooltip": "Full resource name, e.g. customers/123/userLists/456. Use either this or User List ID.",
            "index": 4
          },
          "name": {
            "type": "text",
            "label": "Name",
            "tooltip": "New name for the user list. Must be unique per customer.",
            "index": 5
          },
          "description": {
            "type": "textarea",
            "label": "Description",
            "tooltip": "New description for the user list.",
            "index": 6
          },
          "membershipLifeSpan": {
            "type": "number",
            "label": "Membership Life Span (days)",
            "tooltip": "Number of days a user's cookie stays on the list (0-540, or 10000 for no expiration for CRM lists).",
            "index": 7
          },
          "integrationCode": {
            "type": "text",
            "label": "Integration Code",
            "tooltip": "ID from external system for correlation with Google Ads.",
            "index": 8
          }
        }
      }
    }
  ],
  "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",
          "type": "CRM_BASED",
          "membershipStatus": "OPEN",
          "membershipLifeSpan": "30",
          "integrationCode": "crm-segment-42"
        },
        "properties": {
          "resourceName": {
            "type": "string",
            "title": "Resource Name"
          },
          "id": {
            "type": "string",
            "title": "ID"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "membershipStatus": {
            "type": "string",
            "title": "Membership Status"
          },
          "membershipLifeSpan": {
            "type": "string",
            "title": "Membership Life Span"
          },
          "integrationCode": {
            "type": "string",
            "title": "Integration Code"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
