Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

Questa pagina fornisce le note di rilascio per l'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 controllo delle versioni 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-10-02

Report

È stata aggiunta la dimensione TRAFFIC_SOURCE, che consente di suddividere le metriche in base alla sorgente di traffico (ad es. "Google", "Bing", "Facebook", "Altro"). Per saperne di più, consulta Suddivisione delle sorgenti di traffico.

2025-05-06

PolicyIssues

Il campo obsoleto policyTopics[].must_fix (vedi l'aggiornamento precedente) ora sarà sempre impostato su false.

24/02/2025

PolicyIssues

È stato aggiunto un campo policyTopics[].type per identificare se un argomento delle norme rappresenta un problema relativo alle norme, un problema legislativo 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 generare report sulle violazioni delle norme e sugli avvisi attuali relativi a un account.

2023-06-19

Pagamenti

payments.list ora restituisce i dettagli sui pagamenti per gli editori 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 esempio, 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 della pagina (con alcune limitazioni, vedi Suddivisione dell'URL della pagina).

2022-09-21

AdUnits

Sono stati aggiunti i metodi di creazione 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 di creazione, patch e aggiornamento. 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 di piattaforme di suddividere le metriche in base ai loro account editore (editori host) e ai subaccount (editori di piattaforme).

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

Gli account inattivi vengono ora restituiti dall'API, con un campo state che indica lo stato dell'account.

AdClient

Analogamente alle modifiche all'account, ora l'API restituisce i client pubblicitari inattivi, con un campo state che indica lo stato del client pubblicitario.

2022-02-24

Pagamento

Il formato del nome della risorsa è stato esteso per supportare risorse separate per gli utili di YouTube. Questa modifica precede l'implementazione graduale dell'esperienza AdSense migliorata per i creator di YouTube, in cui gli utili di YouTube verranno separati in un account pagamenti distinto. Anche i dati di pagamento di YouTube verranno restituiti dal metodo di elenco dei pagamenti, una volta che avrai un account pagamenti dedicato per gli utili di YouTube. Gli utili di YouTube avranno il seguente formato del nome della risorsa:
- accounts/{account}/payments/youtube-unpaid per gli utili di YouTube non pagati (correnti).
- accounts/{account}/payments/youtube-yyyy-MM-dd per gli utili di YouTube a pagamento.
Nota:i nomi delle risorse per gli utili AdSense rimangono invariati:
- accounts/{account}/payments/unpaid per gli utili AdSense non pagati (correnti).
- accounts/{account}/payments/yyyy-MM-dd per gli utili AdSense pagati.

2021-06-30

Segnala

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 deprecate 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 ritirati nella versione 1.4 sono stati rimossi. Sono inclusi i metodi delle risorse che non richiedevano un accountId. Nella versione 2, il accountId è specificato nel campo parent.
In base agli standard delle API di Google, le risorse ora sono identificate da un campo name. Ad esempio, il nome di un AdClient avrebbe il seguente aspetto: accounts/{accountId}/adclients/{adClientId}. Inoltre, nella versione 1.4 l'ID risorsa veniva utilizzato come dimensione dei report, ma nella versione 2 questo valore è ora disponibile tramite un campo reporting_dimension_id in diverse 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 che contiene un elenco di attività in sospeso che devono essere completate nell'ambito della procedura di registrazione di un nuovo account. Ad esempio, le attività potrebbero essere correlate al tuo profilo pagamenti o alla verifica del telefono.
Il campo sub_accounts è stato rimosso. Funzionalità simili possono essere ottenute nella v2 con il metodo personalizzato listChildAccounts. L'intero albero degli account secondari può essere generato nella versione 2 chiamando listChildAccounts in modo ricorsivo.

AdClient

È stato rimosso il campo arc_opt_in perché è già stato rimosso dall'interfaccia utente AdSense.
Il campo supports_reporting viene sostituito dal campo reporting_dimension_id, che rappresenta l'ID univoco del cliente pubblicitario utilizzato nella dimensione AD_CLIENT_ID dei report. Se reporting_dimension_id è vuoto, allora AdClient non supporta i report.

AdUnit

Il campo status è stato rinominato in state. Inoltre, lo stato ACTIVE non indica più se si è verificata attività su questa unità pubblicitaria negli ultimi sette giorni. Nella versione 2, significa che l'unità pubblicitaria è stata attivata dall'utente e può pubblicare annunci.
Il campo code è stato rimosso. Questo valore può comunque essere trovato alla fine del campo name (dopo l'ultima barra obliqua).
Il campo contentAdsSettings.backupOption è stato rimosso.
Il campo type è stato limitato ai valori TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT e LINK.
Sono stati rimossi anche 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ò comunque essere trovato alla fine del campo name (dopo l'ultima barra obliqua).
Il campo targeting_info è stato rimosso perché è già stato rimosso dall'interfaccia utente di AdSense.

Pagamento

Il campo payment_date è stato rinominato in date e il tipo è stato modificato da stringa a google.type.Date.
Il campo payment_amount e il campo payment_amount_currency_code sono stati combinati in un unico campo payment (ad es. "¥1235 JPY", "$1234.57", "£87.65").

Segnala

Con la versione 2, i dati dei report dell'API AdSense Management ora sono allineati all'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 tre anni.
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 della query nella versione 1.4. Nota: per la compressione, puoi comunque utilizzare l'intestazione HTTP "Accept-Encoding: gzip".
Alcuni campi sono stati modificati nella 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: di conseguenza, le parole chiave relative alla data (ad es. "today-6d") non sono più supportati.
- Il campo booleano use_timezone_reporting è stato sostituito con reporting_time_zone, che può avere uno dei due valori: ACCOUNT_TIME_ZONE o GOOGLE_TIME_ZONE (che significa PST/PDT). Il valore predefinito nella v2 è ACCOUNT_TIME_ZONE, che differisce dal valore predefinito nella v1.4.
- Il campo start_index è stato rimosso.
- Il campo max_results è stato rinominato in limit.
Alcuni campi sono stati modificati nella generazione dei report salvati.
- Aggiunti campi 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 sui 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.