Mutate operations quota and MutateKeywordPlanAdGroupKeywords

[Alexey]

Hello,

I am using the code from the example

https://developers.google.com/google-ads/api/docs/keyword-planning/generate-historical-metrics

And I can't understand how the limits work in this case.

We have basic access.

I request 10000 keywords once and I get a result for 10000 words.
But if I request again after a few minutes again 10000 keywords then I get the error StatusCode.RESOURCE_EXHAUSTED

This means that the limit of 5000/mutations per day applies to the batch MutateKeywordPlanAdGroupKeywords in 10000 keywords?
Or one request with 10000 keywords in Mutate should MutateKeywordPlanAdGroupKeywords still count as one mutation??

The request looks like:

-------

Method: /google.ads.googleads.v10.services.KeywordPlanAdGroupKeywordService/MutateKeywordPlanAdGroupKeywords

Host: googleads.googleapis.com

Headers: {

"developer-token": "REDACTED",

"login-customer-id": "xxxxxxxxx",

"x-goog-api-client": "gl-python/3.9.9 grpc/1.46.3 gax/2.8.0 gccl/16.0.0",

"x-goog-request-params": "customer_id=xxxxxxxxx"

}

Request: customer_id: "xxxxxxxxx"

operations {

create {

match_type: BROAD

keyword_plan_ad_group: "customers/xxxxxxxxx/keywordPlanAdGroups/422881460"

text: "rbs bankline"

cpc_bid_micros: 1000000

}

}

operations {

create {

match_type: BROAD

keyword_plan_ad_group: "customers/xxxxxxxxx/keywordPlanAdGroups/422881460"

text: "rbs"

cpc_bid_micros: 1000000

}

}

operations {

create {

match_type: BROAD

keyword_plan_ad_group: "customers/xxxxxxxxx/keywordPlanAdGroups/422881460"

text: "1"

cpc_bid_micros: 1000000

}

}

operations {

create {

match_type: BROAD

keyword_plan_ad_group: "customers/xxxxxxxxx/keywordPlanAdGroups/422881460"

text: "2"

cpc_bid_micros: 1000000

}

}

......

[Alexey]

sorry i made a mistake.....
instead of 5000/mutations per day you need to read 15000 API operations per day

[Alexey]

I also got a quota limit for Method: /google.ads.googleads.v10.services.GoogleAdsService/Search

status = StatusCode.RESOURCE_EXHAUSTED

This is a simple request, I called it 3 times in a few minutes and got RESOURCE_EXHAUSTED.
I don't understand how limits work

[Google Ads API Forum Advisor]

Hi Alexy,

Thank you for reaching out to us.

Since you have encountered the quota_error: RESOURCE_EXHAUSTED,it means that a system frequency limit has been exceeded. Kindly prevent sending too many requests in a short period of time and also ensure to set up short delays between requests or combine more operations in fewer requests. You can check this documentation for more details.

You may note that Mutate requests has 5,000 operations per request and if exceeds it, it will give a TOO_MANY_MUTATE_OPERATIONS error.

Moving forward to the “I request 10000 keywords once and I get a result for 10000 words.But if I request again after a few minutes again 10000 keywords then I get the error StatusCode.RESOURCE_EXHAUSTED” and "one request with 10000 keywords in Mutate should MutateKeywordPlanAdGroupKeywords still count as one mutation?"

- You may note that KeywordPlanAdGroupKeyword can have only a 10,000 maximum number, if you exceed with that, you will automatically get a RESOURCE_EXHAUSTED error. You may check this documentation for this.

For this one,”sorry i made a mistake,instead of 5000/mutations per day you need to read 15000 API operations per day”

-as per API Limits and Quotas documentation , this one is in the limitation of the Operations with Basic Access because the maximum number of this is 15,000 API operations per day, if you exceed this, you will automatically get a RESOURCE_EXHAUSTED error. For you to prevent this, I would suggest you apply for unlimited Google Ads API operations, you may fill out the standard access application form . You can check this documentation for more details.

Best regards,

Heidi Google Ads API Team

ref:_00D1U1174p._5004Q2bb7Hz:ref

[Alexey]

Hello,

thanks for your detailed answer.

As I understand it, with 15000 operations/day quota I can request only two GenerateHistoricalMetricsRequest per day, one with 10'000 keywords plan and another around 5'000 keywords?

And as I understand, one MutateKeywordPlanAdGroupKeywords with 10'000 keywords plan uses 10'000 operations from a daily quota of 15'000 operations?

Thank you,

Alexey.

[Google Ads API Forum Advisor]

Hi Alexey,

Thank you for the reply. I am also a member of the Google Ads API team and let me provide support to your concern.

I would like to clarify first that the GenerateHistoricalMetricsRequest is counted against the Get requests limit which is 1,000 requests per day regardless of what access level your developer token has. Please note that the GenerateHistoricalMetricsRequest is counted as 1 request only regardless whether the KeywordPlanAdGroupKeyword reached the 10,000 limit per KeywordPlan or not.

However, the resource exhausted error that you encountered appears related to what was discussed on this document. Please note that limited to 1 request per second per CID or developer token the following get methods:

• KeywordPlanService.GetKeywordPlan
• KeywordPlanService.GenerateHistoricalMetrics
• KeywordPlanService.GenerateForecastMetrics

Requests that violate these limitations are rejected with the error: RESOURCE_EXHAUSTED.

Let me know if you have further questions.

Regards,

Ernie John Google Ads API Team

ref:_00D1U1174p._5004Q2bb7Hz:ref

[Alexey]

Hello,

Does this mean one MutateKeywordPlanAdGroupKeywords with 10`000 keywords cosumes 10`000 operations from a daily quota of 15'000 operations?

Thank you,

Alexey.

[Google Ads API Forum Advisor]

Hi Alexey,

Thank you for the reply.

For this question,"Does this mean one MutateKeywordPlanAdGroupKeywords with 10`000 keywords cosumes 10`000 operations from a daily quota of 15'000 operations?"

-Please note that the keywords are different from operations. With this, my answer is no. The count of this is only one operation.

Best regards,

Heidi Google Ads API Team

ref:_00D1U1174p._5004Q2bb7Hz:ref