Upgrade CombinedRuleUserList (ruleOperator = AND) to the new FlexibleRuleUserListInfo

[Ye Haily]

Hello, 

I saw API V13 only support FlexibleRuleUserListInfo. When I get existing CombinedRuleUserLists by API V13, I couldn't get rule info detail for CombinedRuleUserList  which ruleOperator is AND. 

But the doc Upgrade to the latest version  |  Google Ads API  |  Google Developers said:

Run a GoogleAdsService.search query to select the existing CombinedRuleUserListinfo or ExpressionRuleUserListInfo as a FlexibleRuleUserListInfo. This will transform the list into the correct format for re-upload.

Please let me know how can I get CombinedRuleUserList rule which ruleOperator is AND by API V13. 

Example CombinedRuleUserList:

Result from V13:

{
"userList": {
"resourceName": "customers/6719325552/userLists/982240039",
"type": "RULE_BASED",
"accessReason": "OWNED",
"accountUserListStatus": "ENABLED",
"ruleBasedUserList": {
"prepopulationStatus": "REQUESTED"
},
"id": "982240039",
"readOnly": false,
"name": "CombinedRuleUserList1(AND)",
"membershipLifeSpan": "1",
"eligibleForSearch": true,
"eligibleForDisplay": true
}
}

[Google Ads API Forum Advisor]

Hi Ye,

Thank you for reaching out to us.

Since CombinedRuleUserListInfo and ExpressionRuleUserListInfo have been removed in v13 and you want to transform the CombinedRuleUserLists to FlexibleRuleUserListInfo by the process you saw here and you are looking for a workaround to get the CombinedRuleUserListInfo first, then I would suggest you retrieve first the resource name of the CombinedRuleUserList in v12 while it is still not deprecated and sunsetted. After you do that, you may proceed with the guidance you saw here to transform it to FlexibleRuleUserListInfo.

Let me know if this is what you are looking for; if not, then I would be needing your help to kindly elaborate and provide more details on it, so that we could provide precise guidance accordingly.

Best regards,

Google Ads API Team

ref:_00D1U1174p._5004Q2k1HLI:ref

[Ye Haily]

Thanks for your reply.

This isn't what I'm looking for. The doc mentioned using API V13 to select FlexibleRuleUserListInfo will transform the list into the correct format. In my test, I can get other user list rules by this way, but for a CombinedRuleUserList which ruleOperator is AND, I couldn't get the rule detail from API V13 FlexibleRuleUserListInfo. Need your help to get the rule from API V13.

There're results from API V12 and V13 for one same CombinedRuleUserList which ruleOperator is AND:

Result from V12:

{
         "userList":{
            "resourceName":"customers/6719325552/userLists/982240039",
            "type":"RULE_BASED",
            "accessReason":"OWNED",

            "ruleBasedUserList":{
               "combinedRuleUserList":{
                  "leftOperand":{
                     "ruleType":"OR_OF_ANDS",
                     "ruleItemGroups":[
                        {
                           "ruleItems":[
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"aaa"
                                 },
                                 "name":"url__"
                              },
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"bbb"
                                 },
                                 "name":"url__"
                              }
                           ]
                        },
                        {
                           "ruleItems":[
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"ccc"
                                 },
                                 "name":"url__"
                              }
                           ]
                        }
                     ]
                  },
                  "rightOperand":{
                     "ruleType":"OR_OF_ANDS",
                     "ruleItemGroups":[
                        {
                           "ruleItems":[
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"ddd"
                                 },
                                 "name":"url__"
                              }
                           ]
                        },
                        {
                           "ruleItems":[
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"eee"
                                 },
                                 "name":"url__"
                              },
                              {
                                 "stringRuleItem":{
                                    "operator":"CONTAINS",
                                    "value":"fff"
                                 },
                                 "name":"url__"
                              }
                           ]
                        }
                     ]
                  },
                  "ruleOperator":"AND"

               }
            },
            "id":"982240039",
            "readOnly":false,
            "name":"CombinedRuleUserList1(AND)",

            "description":"Description of CombinedRuleUserList1(AND)",
            "membershipLifeSpan":"1"
         }
      }

Result from V13:

{
"userList": {
"resourceName": "customers/6719325552/userLists/982240039",
"type": "RULE_BASED",
"accessReason": "OWNED",
"accountUserListStatus": "ENABLED",
"ruleBasedUserList": {
"prepopulationStatus": "REQUESTED"
},
"id": "982240039",
"readOnly": false,
"name": "CombinedRuleUserList1(AND)",
"membershipLifeSpan": "1",
"eligibleForSearch": true,
"eligibleForDisplay": true
}
}

[Google Ads API Forum Advisor]

Hi Ye,

Thank you for the reply.

Upon checking, I can see that you are providing us the response logs. However, for our team to further check this and see the full picture of what you are doing, could you please provide us with the complete API logs (request and response with request-id) generated on your end?

Note that logs can be requested or provided to the developer handling the Google Ads API transactions when logging of the API requests has been enabled. You may check here and click your client library for the specific guideline to enable it.

For REST interface requests, you can enable logging via the curl command by using the -i flag. This will cause the tool to include the HTTP response headers in the output.

You may then send the requested information via the Reply privately to author option. If this option is not available, you may send the details directly to our googleadsa...@google.com alias instead

Best regards,

[Ye Haily]

Hi,

It has been over 3 months since you confirmed the CombinedRuleUserList with a ruleOperator of AND is not yet supported in the API V13 though email("RE: Private message regarding: Upgrade CombinedRuleUserList (ruleOperator = AND) to the new FlexibleRuleUserListInfo") .Besides, API V14 also doesn’t support it.

You also confirmed that you raised a feature request with your wider team for this. But we couldn’t see any mention of it in the latest release notes  Release Notes  |  Google Ads API  |  Google for Developers

We can get these data through API V12 but cannot through API V13/V14. It's a breaking change and blocks us migrating to API V13/V14. It's a blocking issue that needs to be fixed quickly, not just a feature request.

Could you let us know when the breaking change can be fixed?

[Google Ads API Forum Advisor]

Hi Ye,

Thank you for the reply.

Allow me to raise this issue to my team for further checking. Rest assured that we will provide updates when become available.
 

This message is in relation to case "ref:_00D1U1174p._5004Q2k1HLI:ref"

Thanks,

 

Google Ads API Team

[Google Ads API Forum Advisor]

Hi Ye,

In addition to my previous email, kindly note that in the v13 release notes, it mentioned that CombinedRuleUserListInfo and ExpressionRuleUserListInfo and their references from RuleBasedUserListInfo were removed, and you may use FlexibleUserListInfo instead. You may check this documentation (https://developers.google.com/google-ads/api/docs/release-notes#audiences_2) for more information.
 

[Ye Haily]

Hi,

What I mean is when query FlexibleUserListInfo,  rule info detail for  CombinedRuleUserList with a ruleOperator of AND cannot be returned. I sent the logs via the Reply privately to author option before. Then you confirmed that "I can confirm the CombinedRuleUserList with a ruleOperator of AND is not yet supported in the API. Based on the Quick diff comparison for /common/user_lists.proto in our diff table, OR of ANDs is the only supported type for FlexibleRuleUserList." Attached the screenshot of the email thread at May.

I will also send the logs for API V12 and API V14 via Reply to author option again. From the logs, you can see we can get rule details for userlist 982240039 from API V12 , but cannot get rule details for userlist 982240039 from API V14 flexibleRuleUserList.

You also confirmed that you raised a feature request with your wider team for this. But 3 months passed, we couldn’t still see any mention of it in the latest release notes  Release Notes  |  Google Ads API  |  Google for Developers

We can get these data through API V12 but cannot through API V13/V14. It's a breaking change and blocks us migrating to API V13/V14. It's a blocking issue that needs to be fixed quickly, not just a feature request.

Could you let us know when the breaking change can be fixed?

[Ye Haily]

Thanks for your reply in email:

Yes, it's a bug that needs to be fixed urgently.

 

From Deprecation and sunset  |  Google Ads API  |  Google for Developers, API V12 will sunset in Sep.27, 2023. After this time, we cannot get the rule details of CombinedRuleUserList with RuleOperator of AND. Could you postpone the sunset time until the bug is fixed?