Annuncio della versione 17 dell'API Google Ads

Mercoledì 5 giugno 2024

Oggi annunciamo il rilascio della versione 17 dell'API Google Ads. Per utilizzare alcune delle funzionalità della versione 17, dovrai eseguire l'upgrade delle librerie client e del codice client. Le librerie client e gli esempi di codice aggiornati verranno pubblicati la prossima settimana.

Riportiamo di seguito alcune delle principali novità:

• Per prepararti alla modifica della norma di utilizzo delle risorse che avverrà il 17 giugno 2024, abbiamo aggiunto due nuovi valori a QuotaError, generati per un consumo eccessivo di risorse in un periodo di tempo da un pattern di query per le richieste GoogleAdsService.Search() e GoogleAdsService.SearchStream().
• Il campo page_size è sempre impostato su 10.000 e non puoi più passare un page_size a GoogleAdsService.Search. In questo modo verrà generato un errore RequestError.PAGE_SIZE_NOT_SUPPORTED.
• Sono stati aggiunti campaign_aggregate_asset_view e channel_aggregate_asset_view per generare report su più metriche delle campagne Performance Max e delle campagne sulla rete di ricerca.
• Modifiche all'elaborazione batch:
  • Aggiunto il supporto per l'impostazione di MutateOperation.asset_group_operation quando si utilizza BatchJobService. In questo modo, puoi utilizzare l'elaborazione batch per creare e gestire intere campagne Performance Max.
  • Aggiunto l'errore BatchJobError.REQUEST_TOO_LARGE per l'invio di un AddBatchJobOperationsRequest di dimensioni superiori a 10.484.504 byte. Devi suddividere le operazioni in gruppi più piccoli e inviarli come richiesta separata.
• È stato aggiunto Campaign.keyword_match_type per consentire l'impostazione di un tipo di corrispondenza delle parole chiave per tutte le parole chiave di una campagna.
• Rimosso AdService.getAd per allineare il servizio con altri nell'API Google Ads. Per suggerimenti su come recuperare le risorse, consulta Recupero degli oggetti.
• Sono stati aggiunti primary_status e primary_status_reasons a AdGroupCriterion per mostrare se il criterio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato.
• È stato aggiunto un nuovo report shopping_product, che corrisponde alla pagina Prodotti della UI di Google Ads.
• Sono state aggiunte altre convalide per ImageAdInfo.image_asset relative alle dimensioni e al formato, per renderle più coerenti con le altre convalide delle immagini nell'API Google Ads.
• È stato aggiunto segments.sk_ad_network_redistributed_fine_conversion_value, che ridistribuisce i valori NULL ad altri valori in base a un modello di machine learning sui dati di postback SkAdNetwork recenti.
• Discovery è stato rinominato in Demand Gen in tutti i campi, gli enum e gli errori di tutte le risorse nell'API Google Ads.
• Ora puoi selezionare solo i campi correlati a un prodotto collegato quando esegui query su product_link. In caso contrario, verrà generato l'errore QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
• È stato aggiunto UserListCustomerTypeService.MutateUserListCustomerTypes() per configurare i tipi di clienti dei segmenti di pubblico. Questo metodo sostituisce l'utilizzo di CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
• Sono stati aggiunti due campi expiration_date_time local_services_verification_artifact per consentire agli inserzionisti di monitorare meglio la scadenza dei loro elementi.

Dove posso trovare ulteriori informazioni?
Le seguenti risorse possono aiutarti a iniziare:

• Note di rilascio
• Guide
• Reference
• Differenze tra v16 e v17

Per qualsiasi domanda o se hai bisogno di ulteriore assistenza, contattaci tramite il forum.

 - Thanet Knack Praneenararat, per conto del team API Google Ads

Etichette: google-ads-api, release