Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

Questa pagina fornisce le note di rilascio dell'API AdSense Management.

Versione 2

Questa versione introduce le seguenti modifiche per rimuovere le funzionalità ritirate e allineare l'API AdSense Management agli standard attuali delle API di Google. In base allo schema di versionamento delle API di Google, questa versione verrà aggiornata nel tempo per includere funzionalità aggiuntive (compatibili con le versioni precedenti) anziché nuove funzionalità rilasciate in versioni secondarie separate.

2025-02-24

PolicyIssues

È stato aggiunto un campo policyTopics[].type per identificare se un argomento delle norme rappresenta un problema relativo alle norme, un problema normativo o una preferenza dell'inserzionista. Questo sostituisce policyTopics[].must_fix, che ora è contrassegnato come campo deprecato.

2024-04-03

PolicyIssues

È stata aggiunta una nuova raccolta per segnalare le violazioni e gli avvisi attuali delle norme presenti per un account.

2023-06-19

Pagamenti

payments.list ora restituisce i dettagli sui pagamenti per i publisher premium.

2023-06-13

Report

Sono state aggiunte le metriche FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS e FUNNEL_RPM, che forniscono informazioni sul rendimento delle unità non pubblicitarie (ad es. le unità di ricerca correlate).

2023-03-30

Report

È stata aggiunta la dimensione PAGE_URL, che consente di suddividere le metriche in base all'URL pagina (con alcune limitazioni, consulta la sezione Suddivisione per URL pagina).

2022-09-21

AdUnits

Sono stati aggiunti i metodi create e patch. Tieni presente che questi metodi possono essere utilizzati solo dai progetti abilitati per il prodotto AdSense per le piattaforme.

CustomChannels

Sono stati aggiunti i metodi create, patch e update. Tieni presente che questi metodi possono essere utilizzati solo dai progetti abilitati per il prodotto AdSense per le piattaforme.
È stato aggiunto il campo attivo alla risorsa.

Account

È stato aggiunto il metodo getAdBlockingRecoveryTag.

2022-08-25

Report

È stata aggiunta la dimensione HOSTED_AD_CLIENT_ID, che consente agli editori host e della piattaforma di suddividere le metriche in base agli account dell'editore (editori host) e ai subaccount (editori della piattaforma).

2022-05-03

AdClient

È stato aggiunto il metodo get.

Report

È stato aggiunto il metodo getSaved.

UrlChannels

È stato aggiunto il metodo get.

2022-03-31

Account

Ora gli account inattivi vengono restituiti dall'API con un campo state che indica lo stato dell'account.

AdClient

Analogamente alle modifiche dell'account riportate sopra, ora l'API restituisce i client di annunci inattivi con un state campo che indica lo stato del client di annunci.

2022-02-24

Pagamento

Il formato del nome della risorsa è stato esteso per supportare risorse separate per gli utili di YouTube. Questa modifica viene applicata prima dell'implementazione graduale della nuova esperienza AdSense per i creator di YouTube, in cui gli utili di YouTube verranno suddivisi in un account pagamenti dedicato. Una volta ottenuto un account pagamenti dedicato per gli utili di YouTube, i dati di pagamento di YouTube verranno restituiti anche dal metodo dell'elenco pagamenti. Gli utili di YouTube avranno il seguente formato del nome della risorsa:
- accounts/{account}/payments/youtube-unpaid per gli utili di YouTube non pagati (attuali).
- accounts/{account}/payments/youtube-yyyy-MM-dd per gli utili di YouTube pagati.
Nota: i nomi delle risorse per le entrate di AdSense rimangono invariati:
- accounts/{account}/payments/unpaid per gli utili di AdSense non corrisposti (attuali).
- accounts/{account}/payments/yyyy-MM-dd per gli utili di AdSense corrisposti.

2021-06-30

Report

Sono state aggiunte le dimensioni AD_FORMAT_NAME e AD_FORMAT_CODE, che indicano il modo in cui un annuncio viene mostrato agli utenti sul tuo sito (in-page, vignetta e così via). Tieni presente che la versione 1.4 aveva dimensioni (riservate) con gli stessi nomi, ma membri diversi. Le due dimensioni aggiunte nella versione 2 sono diverse da quelle presenti nella versione 1.4.

19-04-2021 (release iniziale)

Generali

Tutti i metodi deprecati nella versione 1.4 sono stati rimossi. Sono inclusi i metodi delle risorse che non richiedevano un accountId. Nella versione 2, il valore accountId è specificato nel campo parent.
In base agli standard delle API di Google, le risorse ora sono identificate da un name campo. Ad esempio, il nome di un account cliente pubblicitario è simile a accounts/{accountId}/adclients/{adClientId}. Inoltre, nella v1.4 l'ID risorsa veniva utilizzato come dimensione dei report, ma nella v2 questo valore è ora disponibile tramite un campo reporting_dimension_id in più risorse.
Il campo kind è stato rimosso da tutte le risorse.

Account

Il campo name è stato modificato in display_name.
Il campo timezone è stato modificato da una stringa a un google.type.TimeZone.
Il campo creation_time (tipo int64) è stato modificato in create_time (tipo google.protobuf.Timestamp).
È stato aggiunto un campo pending_tasks, ovvero un elenco di attività in sospeso da completare durante la procedura di registrazione di un nuovo account. Ad esempio, le attività potrebbero essere correlate al tuo profilo di fatturazione o alla verifica telefonica.
Il campo sub_accounts è stato rimosso. È possibile ottenere una funzionalità simile nella versione 2 con il metodo personalizzato listChildAccounts. L'albero completo degli account secondari può essere generato nella versione 2 chiamando listChildAccounts in modo ricorsivo.

AdClient

È stato rimosso il campo arc_opt_in poiché è già stato rimosso dall'interfaccia utente di AdSense.
Il campo supports_reporting viene sostituito con il reporting_dimension_id, che rappresenta l'ID univoco dell'account cliente come utilizzato nella dimensione dei report AD_CLIENT_ID. Se reporting_dimension_id è vuoto, significa che AdClient non supporta i report.

AdUnit

Il campo status è stato rinominato in state. Inoltre, lo stato ACTIVE non indica più se è stata registrata attività su questa unità pubblicitaria negli ultimi sette giorni. Nella versione 2, indica che l'unità pubblicitaria è stata attivata dall'utente e può pubblicare annunci.
Il campo code è stato rimosso. Questo valore può essere trovato alla fine del campo name (dopo l'ultima barra forward).
Il campo contentAdsSettings.backupOption è stato rimosso.
Il campo type è stato limitato ai valori TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT e LINK.
Verranno inoltre rimossi altri campi già rimossi nell'interfaccia utente di AdSense: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Avviso

Il metodo delete è stato rimosso.
Il campo is_dismissible è stato rimosso.
Il campo locale è stato rinominato in language_code.

CustomChannel

Il campo code è stato rimosso. Questo valore può essere trovato alla fine del campo name (dopo l'ultima slash).
Il campo targeting_info è stato rimosso poiché è già stato rimosso dall'interfaccia utente di AdSense.

Pagamento

Il campo payment_date è stato rinominato date e il tipo è passato da stringa a google.type.Date.
Il campo payment_amount e il payment_amount_currency_code sono stati combinati in un singolo payment (ad es. "1.235 ¥", "1.234,57 $", "87,65 £").

Report

Con la versione 2, i dati dei report dell'API AdSense Management ora sono in linea con l'interfaccia utente di AdSense. Ciò significa che le proprietà AdMob e YouTube non sono più supportate. Inoltre, l'API supporterà solo i dati dei report risalenti a 3 anni fa.
La risorsa Metadata.dimensions e la risorsa Metadata.metrics sono state rimosse.
Sono stati aggiunti nuovi metodi per generare una versione CSV del report, sostituendo i parametri di query nella versione 1.4. Nota: per la compressione, puoi comunque utilizzare l'intestazione HTTP "Accept-Encoding: gzip".
Alcuni campi sono stati modificati durante la generazione di report ad hoc.
- Il campo account_id è stato rinominato in account.
- Il campo dimension è stato rinominato in dimensions.
- Il campo metric è stato rinominato in metrics.
- Il campo filter è stato rinominato in filters.
- Il campo sort è stato rinominato in order_by.
- Il campo locale è stato rinominato in language_code.
- Il campo currency è stato rinominato in currency_code.
- Ora puoi specificare diversi intervalli comuni con date_range (ad es. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS e LAST_30_DAYS) oppure puoi specificare un start_date e un end_date impostando date_range su CUSTOM.
- I campi start_date e end_date sono stati modificati dal tipo stringa al tipo google.type.Date. Nota: come risultato, le parole chiave relative alle date (ad es. "oggi-6gg") non sono più supportati.
- Il campo booleano use_timezone_reporting è stato sostituito con reporting_time_zone, che può avere uno di due valori: ACCOUNT_TIME_ZONE o GOOGLE_TIME_ZONE (che significa PST/PDT). Il valore predefinito nella v2 è ACCOUNT_TIME_ZONE, che è diverso da quello predefinito nella v1.4.
- Il campo start_index è stato rimosso.
- Il campo max_results è stato rinominato in limit.
Alcuni campi sono stati modificati durante la generazione dei report salvati.
- Sono stati aggiunti i campi della data (date_range, start_date, end_date, reporting_time_zone).
- È stato aggiunto un campo currency_code.
- Il campo locale è stato rinominato in language_code.
- Il campo start_index è stato rimosso.
- Il campo max_results è stato rimosso.

SavedAdStyle

SavedAdStyle è stato rimosso perché è già stato rimosso dall'interfaccia utente di AdSense.

Sito

Sites sono stati aggiunti per recuperare i dati dei siti web che hai aggiunto al tuo account AdSense.
Il campo state indica se il sito si trova in uno dei seguenti stati: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Il campo auto_ads_enabled è un valore booleano che indica se gli annunci automatici sono stati attivati su un determinato sito.