GoogleAdsGoogleadsV25Services__ListPlannableUserListsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-list-plannable-user-lists-response-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__ListPlannableUserListsResponse",
  "description": "A response with all available user lists with their plannable status.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-v25-listplannableuserlists-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__ListPlannableUserListsResponse",
  "type": "object",
  "properties": {
    "plannableUserLists": {
      "type": "array",
      "description": "The list of user lists available for planning and related targeting metadata.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__PlannableUserList"
      }
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Common__UserListInfo": {
      "type": "object",
      "properties": {
        "userList": {
          "type": "string",
          "description": "The User List resource name."
        }
      },
      "description": "A User List criterion. Represents a user list that is defined by the advertiser to be targeted."
    },
    "GoogleAdsGoogleadsV25Services__PlannableUserList": {
      "description": "A plannable user list.",
      "type": "object",
      "properties": {
        "userListInfo": {
          "description": "The user list ID.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__UserListInfo"
        },
        "userListType": {
          "type": "string",
          "description": "The user list type.",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "UserList represented as a collection of conversion types.",
            "UserList represented as a combination of other user lists/interests.",
            "UserList created in the Google Ad Manager platform.",
            "UserList associated with a rule.",
            "UserList with users similar to users of another UserList.",
            "UserList of first-party CRM data provided by advertiser in the form of emails or other formats.",
            "LookalikeUserlist, composed of users similar to those of a configurable seed (set of UserLists)"
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "REMARKETING",
            "LOGICAL",
            "EXTERNAL_REMARKETING",
            "RULE_BASED",
            "SIMILAR",
            "CRM_BASED",
            "LOOKALIKE"
          ]
        },
        "plannableStatus": {
          "type": "string",
          "description": "The plannable status of the user list.",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "The user list is plannable.",
            "The user list is not plannable."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "PLANNABLE",
            "UNPLANNABLE"
          ]
        },
        "displayName": {
          "type": "string",
          "description": "The name of the user list."
        },
        "plannableUserListMetadata": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__PlannableUserListMetadata",
          "description": "The relevant metadata for this user list."
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__PlannableUserListMetadata": {
      "type": "object",
      "properties": {
        "userListCrmDataSourceType": {
          "description": "The data source type of a CRM based user list.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "The uploaded data is first-party data.",
            "The uploaded data is from a third-party credit bureau.",
            "The uploaded data is from a third-party voter file.",
            "The uploaded data is third party partner data."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "FIRST_PARTY",
            "THIRD_PARTY_CREDIT_BUREAU",
            "THIRD_PARTY_VOTER_FILE",
            "THIRD_PARTY_PARTNER_DATA"
          ]
        }
      },
      "description": "The metadata associated with a plannable user list."
    }
  }
}