RE: clarification on customer match limits and usage for daily high-volume uploads

[Google Ads API Forum Advisor]

Hi,

Thank you for contacting the Google Ads API support team.

1. Yes, with the basic access hitting 2,500 AddOfflineUserDataJobOperationsRequest calls per day likely exceeds the quota limit. According to this documentation, with basic access a mutate request cannot contain more than 10,000 operations per request and you are planning to execute 500 AddOfflineUserDataJobOperationsRequest calls, each containing 10,000 OfflineUserDataJobOperation. 

2. Yes, batching is highly recommended in this scenario. Note that use of batching can reduce the number of requests sent but its use must be evaluated to see if it's a good fit for your needs. The main reasons for using batch processing are to minimize the number of API requests and retry operations that fail due to transient errors. Batching 10,000 users per request and reducing to 50 as per list per day can hardly make 250 mutate calls per day.

3. To avoid RESOURCE_EXHAUSTED error, set up short delays between requests or combine more operations in fewer requests. I would recommend you to check this sample code for how to Handle a Rate Exceeded Error for more information and Best practices guide to optimize the efficiency and performance.

4. According to Access Levels and Permissible Use documentation, having standard access will allow you to make unlimited API calls. I would recommend you to avoid sending too many requests at a time, so that you can make any number of API calls with standard level access.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-06-10 09:03:50Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01remZC:ref" (ADR-00313411)

[Sundaralingam Kethiri]

Thanks for the clarification. Just to follow up on Access Levels and Permissible Use documentation, I’m using a Basic access developer token and would like clarification on the 15,000 operations/day limit mentioned in the documentation.

In my setup, I upload Customer Match data using AddOfflineUserDataJobOperations, where each OfflineUserDataJobOperation contains one hashed email (i.e., one identifier), and I batch 10,000 operations per AddOfflineUserDataJobOperationsRequest.

Does the 15,000 daily operations limit refer to:

• The total number of OfflineUserDataJobOperation entries (i.e., user-level operations like hashed emails), (If so am I limited to uploading only 15000 identifiers a day with Basic token?)
  or

• The number of API requests (e.g., calls to AddOfflineUserDataJobOperations and RunOfflineUserDataJob)? 

Best regards,
S.Kethiri

[Google Ads API Forum Advisor]

Hi,

Kindly check the below answers for your queries:

The total number of OfflineUserDataJobOperation entries (i.e., user-level operations like hashed emails), (If so am I limited to uploading only 15000 identifiers a day with Basic token?) 

• No, it is not limited to uploading only 15k identifiers a day with a basic access. For optimal performance, it is recommended to include up to 10,000 identifiers per call. However, each AddOfflineUserDataJobOperations request can accommodate a maximum of 100,000 identifiers across all UserData objects in the operations array. I would suggest you refer to this guide to know more information. To make larger AddOfflineUserDataJobOperations requests, please apply for standard access, which has unlimited operations. 

The number of API requests (e.g., calls to AddOfflineUserDataJobOperations and RunOfflineUserDataJob)? 

• I would suggest you to go through these best practices and quota guide to know about the number of requests for AddOfflineUserDataJobOperations. 

If you are facing any issues, then kindly provide us with the OfflineUserDataJob Id and complete API logs (request and response with request-id and request header) generated at your end.

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java, .Net, PHP, Python, Ruby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

You can send the details via Reply privately to the author option or direct private reply to this email.

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-06-19 08:57:42Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01remZC:ref" (ADR-00313411)

[Google Ads API Forum Advisor]

Hi,

I would like to inform you that this product officially offers support only in English. It would be best to reply in English if you can. If not, we will try to use Google Translate to support you as best as we can.

The Basic access allows the developer token to execute up to 15,000 operations per day. A request that is not a Get, Mutate, Search, or SearchStream request counts as one operation against the user's daily operation quota. The OfflineUserDataJobService.AddOfflineUserDataJobOperations and OfflineUserDataJobService.CreateOfflineUserDataJob are examples of such requests.

While creating a customer list using the Google Ads API, for each OfflineUserDataJob, we recommend no more than 1,000,000 'OfflineUserDataJobService.AddOfflineUserDataJobOperations' operations per job for optimal processing. There is no maximum limit on the number of operations you can add to a single job. 

Also, we recommend adding up to 10,000 total identifiers in a single call for optimal processing. A single AddOfflineUserDataJobOperations request can contain at most 100,000 identifiers across all of the UserData objects in the operations list.

So, with just one add operation in the job, you can add 100,000 identifiers across all of the UserData objects. 

We don't have a code example of using 100,000 identifiers in a single reques​​​​​​​t. You can try at your end and let us know if you encounter any issues. I recommend you also refer to the guide on 'API limits and quotas' for more information on the daily operation quotas.

I hope this helps.
 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-06-19 17:17:31Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01remZC:ref" (ADR-00313411)