Aktualisierung der Nutzungsrichtlinie für Ressourcen der Google Ads API

Mittwoch, 1. Mai 2024

Was ändert sich?

Wir aktualisieren die Richtlinie zur Ressourcennutzung der Google Ads API, um GoogleAdsService.Search- und GoogleAdsService.SearchStream-Abfragemuster zu drosseln, die übermäßig viele API-Ressourcen verbrauchen. Wenn ein bestimmtes Abfragemuster gedrosselt wird, funktionieren andere Dienste, Methoden und Abfragemuster weiterhin uneingeschränkt.

Ab der Woche vom 17. Juni 2024 werden Anfragen nur für die gedrosselten Abfragemuster so beeinflusst:

  • Wenn Sie Version 17 oder älter der API verwenden, erhalten Sie den Fehler QuotaError.RESOURCE_EXHAUSTED.
  • Wenn Sie Version 18 oder höher der API verwenden, erhalten Sie je nachdem, ob der übermäßige Ressourcenverbrauch für einen kurzen Zeitraum (einige Minuten) oder einen langen Zeitraum aufgetreten ist, einen QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION oder QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.

Damit Sie Ihre teuren Berichte leichter identifizieren und im Blick behalten können, geben wir auch einen Kostenmesswert für einzelne Berichte zurück. Die Kosten für erfolgreiche Berichte finden Sie in den folgenden Feldern:

Weshalb nehmen wir diese Änderung vor?

Wir nehmen diese Änderung vor, um die Zuverlässigkeit und Stabilität der API zu gewährleisten.

Was muss ich tun?

Aktualisieren Sie Ihre Anwendungen vor dem 17. Juni 2024, um Folgendes zu tun:

  • Neue Fehlercodes bei GoogleAdsService::Search or GoogleAdsService::SearchStream-Aufrufen verarbeiten
    • Wenn Sie Version 17 oder eine frühere Version der Google Ads API verwenden, müssen Sie QuotaError.RESOURCE_EXHAUSTED-Fehler beheben.
    • Wenn Sie Version 18 oder höher der API verwenden, müssen Sie die Fehler QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION und QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION beheben.
  • Wenn eines oder mehrere Ihrer Berichtsanfragemuster gedrosselt werden, sollten Sie das Anfragemuster überprüfen und korrigieren. Hier sind einige Möglichkeiten, die Abfrageleistung zu verbessern:
    • Führen Sie die Abfrage seltener aus.
    • Verwenden Sie ein kostengünstigeres Abfragemuster oder eine kostengünstigere Ansicht.

Weitere Informationen zum Optimieren von Abfragen finden Sie unter Dateneffizienz verwalten.

  • [Optional] Binden Sie den neuen Messwert query_resource_consumption in Ihre Monitoring-Systeme ein, um neue teure Abfragen zu erkennen und zu verarbeiten.

Hilfe

Wenn Sie Fragen zu dieser Änderung haben oder Unterstützung bei der Optimierung bestimmter Abfragemuster benötigen, finden Sie auf der Supportseite für die Google Ads API entsprechende Optionen.

– David Stevens, Google Ads API Produktmanager

Labels: google-ads-api