Ankündigung von Version 17 der Google Ads API

Mittwoch, 5. Juni 2024

Heute kündigen wir die Veröffentlichung von Version 17 der Google Ads API an. Wenn Sie einige der v17-Funktionen verwenden möchten, müssen Sie Ihre Clientbibliotheken und den Clientcode aktualisieren. Die aktualisierten Clientbibliotheken und Codebeispiele werden nächste Woche veröffentlicht.

Hier einige der wichtigsten Neuerungen:

• Zur Vorbereitung auf die Änderung der Richtlinie zur Ressourcennutzung, die am 17. Juni 2024 in Kraft tritt, haben wir QuotaError zwei neue Werte hinzugefügt. Diese werden ausgegeben, wenn ein Abfragemuster für GoogleAdsService.Search()- und GoogleAdsService.SearchStream()-Anfragen über einen bestimmten Zeitraum hinweg zu viele Ressourcen verbraucht.
• Das Feld page_size ist immer auf 10.000 festgelegt und Sie können keinen page_size mehr an GoogleAdsService.Search übergeben. Andernfalls wird ein RequestError.PAGE_SIZE_NOT_SUPPORTED-Fehler ausgegeben.
• campaign_aggregate_asset_view und channel_aggregate_asset_view wurden hinzugefügt, um mehr Messwerte für Performance Max- und Suchkampagnen zu erfassen.
• Änderungen an der Batchverarbeitung:
  • Unterstützung für das Festlegen von MutateOperation.asset_group_operation bei Verwendung von BatchJobService hinzugefügt. So können Sie die Batchverarbeitung verwenden, um ganze Performance Max-Kampagnen zu erstellen und zu verwalten.
  • Der Fehler BatchJobError.REQUEST_TOO_LARGE wurde hinzugefügt, wenn eine AddBatchJobOperationsRequest mit mehr als 10.484.504 Byte gesendet wird. Sie sollten die Vorgänge in kleinere Gruppen aufteilen und als separate Anfrage senden.
• Campaign.keyword_match_type wurde hinzugefügt, damit Sie eine Keyword-Option für alle Keywords in einer Kampagne festlegen können.
• AdService.getAd wurde entfernt, um den Dienst an andere in der Google Ads API anzupassen. Empfehlungen zum Abrufen von Ressourcen finden Sie unter Objekte abrufen.
• primary_status und primary_status_reasons wurden zu AdGroupCriterion hinzugefügt, um anzugeben, ob das Anzeigengruppenkriterium ausgeliefert wird, oder die Gründe dafür, warum es nicht ausgeliefert wird.
• Der neue Bericht shopping_product wurde hinzugefügt. Er entspricht der Seite Produkte der Google Ads-Benutzeroberfläche.
• Es wurden weitere Validierungen für ImageAdInfo.image_asset in Bezug auf Abmessungen und Format hinzugefügt, um die Konsistenz mit anderen Bildvalidierungen in der Google Ads API zu verbessern.
• segments.sk_ad_network_redistributed_fine_conversion_value wurde hinzugefügt. Damit werden NULL-Werte basierend auf einem Modell für maschinelles Lernen, das auf aktuellen SkAdNetwork-Postback-Daten basiert, auf andere Werte umverteilt.
• Discovery wurde in allen Feldern, Enums und Fehlern aller Ressourcen in der Google Ads API in Demand Gen umbenannt.
• Sie können jetzt nur Felder auswählen, die sich auf ein verknüpftes Produkt beziehen, wenn Sie product_link abfragen. Andernfalls wird QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE ausgegeben.
• UserListCustomerTypeService.MutateUserListCustomerTypes() wurde hinzugefügt, um Kundentypen für Zielgruppen zu konfigurieren. Diese Methode ersetzt die Verwendung von CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
• Zwei expiration_date_time-Felder local_services_verification_artifact hinzugefügt, damit Werbetreibende besser im Blick behalten können, wann ihre Artefakte ablaufen.

Wo finde ich weitere Informationen?
Die folgenden Ressourcen können Ihnen beim Einstieg helfen:

• Versionshinweise
• Leitfäden
• Referenz
• Unterschiede zwischen v16 und v17

Wenn du Fragen hast oder Unterstützung benötigst, kannst du dich über das Forum an uns wenden.

 – Thanet Knack Praneenararat, im Namen des Google Ads API-Teams

Labels: google-ads-api, release