Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

Questa pagina fornisce note sulla versione per l'API AdSense Management.

Versione 2

Questa versione introduce le seguenti modifiche al fine di rimuovere funzionalità deprecate e allineare l'API AdSense Management agli attuali standard 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.

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, unità di ricerca correlata).

2023-03-30

Report

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

2022-09-21

AdUnits

Aggiunti metodi di creazione e patch. Tieni presente che questi metodi possono essere utilizzati solo da progetti attivati per il prodotto AdSense per le piattaforme.

CustomChannels

Aggiunti metodi di creazione, patch e aggiornamento. Tieni presente che questi metodi possono essere utilizzati solo da progetti attivati 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 dell'host e della piattaforma 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 getSalvato aggiunto.

UrlChannels

Metodo get aggiunto.

2022-03-31

Account

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

AdClient

Analogamente alle modifiche all'account riportate sopra, ora i client pubblicitari non attivi vengono restituiti dall'API, 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 AdSense migliorata per i creator di YouTube, in base alla quale gli utili di YouTube verranno suddivisi in un account pagamenti dedicato. Anche i dati di pagamento di YouTube verranno restituiti dal metodo dell'elenco pagamenti, una volta che avrai un account pagamenti dedicato per gli utili di YouTube. Gli utili di YouTube avranno il seguente formato per il 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 gli utili di AdSense rimangono invariati:
- accounts/{account}/payments/unpaid per gli utili di AdSense non pagati (attuali).
- accounts/{account}/payments/yyyy-MM-dd per le entrate AdSense pagate.

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, vignettatura e così via). Tieni presente che la v1.4 aveva dimensioni (deprecate) con gli stessi nomi ma membri diversi; le due dimensioni aggiunte nella v2 sono distinte da quelle presenti nella v1.4.

19-04-2021 (release iniziale)

Generali

Tutti i metodi ritirati nella versione 1.4 sono stati rimossi. Sono inclusi metodi delle risorse che non hanno richiesto un accountId. Nella v2, accountId è 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 Ad esempio 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 è un elenco di attività in sospeso che devono essere completate nell'ambito del processo di registrazione per 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. La struttura ad albero completa 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 del report AD_CLIENT_ID. Se 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 è stata rilevata 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.
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 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.
I campi payment_amount e payment_amount_currency_code sono stati combinati in un unico campo payment (ad es. "¥1235 JPY", "$1234,57", "£87,65").

Report

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 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 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 dalla stringa di tipo al 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 significa PST/PDT). Il valore predefinito nella v2 è ACCOUNT_TIME_ZONE, diverso 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 al momento della generazione dei report salvati.
- Campi di 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 è 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.