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 funzionalità deprecate e allineare l'API AdSense Management agli standard attuali dell'API di Google. Secondo lo schema di controllo delle versioni dell'API di Google, questa versione verrà aggiornata nel tempo per includere funzionalità aggiuntive (compatibili con le versioni precedenti), anziché il rilascio di nuove funzionalità in versioni secondarie separate.

2024-04-03

PolicyIssues

È stata aggiunta una nuova raccolta per segnalare le attuali violazioni delle norme e gli avvisi 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 esempio le unità di ricerca correlata).

2023-03-30

Report

È stata aggiunta la dimensione PAGE_URL, che consente di suddividere le metriche per URL della pagina (con alcune avvertenze, consulta la sezione Suddivisione degli URL pagina).

2022-09-21

AdUnits

Sono stati aggiunti metodi di creazione e patch. Tieni presente che questi metodi possono essere utilizzati solo da 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 da progetti abilitati per il prodotto AdSense per le piattaforme.
È stato aggiunto il campo attivo alla risorsa.

Account

È stato aggiunto il metodo getAdBlockRecoveryTag.

2022-08-25

Report

È stata aggiunta la dimensione HOSTED_AD_CLIENT_ID, che consente ai publisher di host e piattaforme di suddividere le metriche in base agli account dei publisher (publisher host) e ai subaccount (publisher della piattaforma).

2022-05-03

AdClient

Metodo get aggiunto.

Report

Metodo getsave aggiunto.

UrlChannels

Metodo get aggiunto.

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 precedenti, l'API restituisce ora i client di annunci inattivi, con un campo state che indica lo stato del client pubblicitario.

2022-02-24

Pagamento

Il formato del nome della risorsa è stato esteso in modo da supportare risorse separate per gli utili di YouTube. Questa modifica è precedente all'implementazione graduale dell'esperienza migliorata di AdSense per i creator di YouTube, in cui gli utili di YouTube verranno separati in un apposito account pagamenti. Anche i dati di pagamento di YouTube verranno restituiti utilizzando il metodo dell'elenco pagamenti, una volta che avrai un account pagamenti dedicato per gli utili di YouTube. Il nome della risorsa degli utili di YouTube sarà il seguente:
- accounts/{account}/payments/youtube-unpaid per utili di YouTube non pagati (attuali).
- accounts/{account}/payments/youtube-yyyy-MM-dd per gli utili di YouTube a pagamento.
Nota:i nomi delle risorse per gli utili di AdSense rimangono invariati:
- accounts/{account}/payments/non pagati per utili di AdSense non pagati (attuali).
- accounts/{account}/payments/yyyy-MM-dd per le entrate AdSense corrisposte.

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 (deprecate) con gli stessi nomi ma membri diversi; le due dimensioni aggiunte nella v2 sono diverse da quelle presenti nella v1.4.

19/04/2021 (release iniziale)

Generali

Tutti i metodi ritirati nella versione 1.4 sono stati rimossi. Questo include metodi delle risorse che non hanno richiesto un accountId. Nella versione 2, accountId viene specificato nel campo parent.
In base agli standard delle API di Google, le risorse sono ora identificate da un campo name. Ad esempio, il nome di un cliente pubblicitario sarebbe 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 su 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 stringa a 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 mostra 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 profilo di fatturazione o alla verifica telefonica.
Il campo sub_accounts è stato rimosso. Funzionalità simili possono essere ottenute nella versione 2 con il metodo personalizzato listChildAccounts. L'intera struttura ad albero dell'account secondario può essere generata nella versione 2 chiamando listChildAccounts in modo ricorsivo.

AdClient

Il campo arc_opt_in è stato rimosso perché è già stato rimosso dall'interfaccia utente di AdSense.
Il campo supports_reporting viene sostituito con il campo reporting_dimension_id, che rappresenta l'ID univoco del client pubblicitario utilizzato nella dimensione dei report AD_CLIENT_ID. Se il campo reporting_dimension_id è vuoto, 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 è ancora disponibile alla fine del campo name (dopo l'ultima barra).
Il campo contentAdsSettings.backupOption è stato rimosso.
Per il campo type sono stati limitati i valori TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT e LINK.
Verranno rimossi anche altri campi che sono già stati rimossi nell'interfaccia utente di AdSense: custom_style, saved_style_id, mobile_content_ads_settings e 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 è ancora disponibile alla fine del campo name (dopo l'ultima barra).
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 cambiato da stringa di tipo a tipo google.type.Date.
Il campo payment_amount e il campo payment_amount_currency_code sono stati combinati in un singolo campo payment (ad es. "¥1235 JPY", "$1,234,57", "£87,65").

Report

Con la versione 2, i dati dei report dell'API AdSense Management ora sono allineati 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 ai 3 anni precedenti.
La risorsa Metadata.dimensions e Metadata.metrics sono state rimosse.
Sono stati aggiunti nuovi metodi per generare una versione CSV del report, sostituendo i parametri di query nella v1.4. Nota: per la compressione, puoi comunque utilizzare l'intestazione HTTP "Accetta-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 start_date e end_date impostando date_range su CUSTOM.
- I campi start_date e end_date sono stati modificati da stringa di tipo a tipo google.type.Date. Nota: di conseguenza, le parole chiave per date relative (ad es. "today-6d") 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 indica 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 durante la generazione del report salvato.
- Campi data aggiunti (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 relativi ai siti web che hai aggiunto al tuo account AdSense.
Il campo state indica se il sito è 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.