[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-08 (世界標準時間)。"],[[["\u003cp\u003eThe Cloud Channel API's \u003ccode\u003ecustomers.list\u003c/code\u003e method allows filtering to find specific customer information using the \u003ccode\u003efilter\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eUsing a filter with \u003ccode\u003ecustomers.list\u003c/code\u003e may cause a brief delay, so if immediate access is needed, it's recommended to use the method without a filter or use \u003ccode\u003ecustomers.get\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003eFilters support exact match or prefix matching, and the search fields include \u003ccode\u003edomain\u003c/code\u003e, \u003ccode\u003eorg_display_name\u003c/code\u003e, \u003ccode\u003ecloud_identity_id\u003c/code\u003e, and \u003ccode\u003echannel_partner_id\u003c/code\u003e, but only domain and org_display_name support prefix filters.\u003c/p\u003e\n"],["\u003cp\u003eThe syntax for exact match filters is \u003ccode\u003e<field> = <value>\u003c/code\u003e, and for prefix filters it's \u003ccode\u003e<field> : <value>*\u003c/code\u003e, with examples provided for clarity.\u003c/p\u003e\n"],["\u003cp\u003eLogical operators AND and OR can be used in filters, however, to use both operators together, you must separate the operations using a parenthetical statement.\u003c/p\u003e\n"]]],[],null,["# Set up a customer filter using the ListCustomers API\n\nIf you need to find information about a specific customer, you can use the\nCloud Channel API `filter` parameter through the\n[`customers.list` method](/channel/docs/reference/rest/v1/accounts.customers/list).\n\nIf you use a filter, there is a short delay (usually a few seconds) during the\ncreation of a customer. If you need access to a customer immediately after\ncreation, we recommend using `customers.list` without a filter or\n[`customers.get`](/channel/docs/reference/rest/v1/accounts.customers/get).\n\nAvailable filters\n-----------------\n\nStrings for the filter parameter support exact match, or exact match plus prefix\nfiltering. Filters are not case sensitive.\n\nThe following table describes the\navailable fields you can search for, and the methods they support.\n\nYou can find the complete filter syntax in the\n[API filtering guide](https://google.aip.dev/160).\n\n### Exact match syntax\n\nExact match filters will only find customers that contain the same fields as\nthose in the submitted string.\n\nSyntax:\n`\u003cdomain | org_display_name | cloud_identity_id | channel_partner_id\u003e = \u003cvalue\u003e`\n\nExample: `domain = \"domain.com\" AND channel_partner_id = \"12345\"`\n\n### Prefix syntax\n\nPrefix filters allow the use of an asterisk as a wild-card symbol. This filter\nwill find customers that have fields with the prefix, regardless of the content\nthat comes after it.\n\nSyntax: `\u003cdomain | org_display_name\u003e : \u003cvalue\u003e*`\n\nExample: `domain : \"uw.com*\" AND org_display_name : \"prefix*\"`\n\nExamples of filters with logical operators\n------------------------------------------\n\nCloud Channel API filters support the use of AND and OR logical operators.\nYou can use both operators in one filter by using a parenthetical statement.\n\n### AND example\n\n`domain = \"domain.com\" AND channel_partner_id = \"12345\" AND org_display_name :\n\"display*\"`\n\n### OR example\n\n`domain = \"domain.com\" OR channel_partner_id = \"12345\" OR org_display_name :\n\"display*\"`\n\n### AND + OR example\n\n`domain = \"domain.com\" OR (channel_partner_id = \"12345\" AND org_display_name :\n\"display*\" )`\n\nYou need to use parentheses if the filter contains an AND and an OR statement.\nThe following example is not a valid filter string.\n\n`domain = \"domain.com\" OR channel_partner_id = \"12345\" AND org_display_name :\n\"display*`"]]
