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
eFUNNEL_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
eAD_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 campoparent
. - 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 sarebbeaccounts/{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 camporeporting_dimension_id
su diverse risorse. - Il campo
kind
è stato rimosso da tutte le risorse.
Account
- Il campo
name
è stato modificato indisplay_name
. - Il campo
timezone
è stato modificato da stringa agoogle.type.TimeZone
. - Il campo
creation_time
(tipo int64) è stato modificato increate_time
(tipogoogle.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 personalizzatolistChildAccounts
. L'intera struttura ad albero dell'account secondario può essere generata nella versione 2 chiamandolistChildAccounts
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 camporeporting_dimension_id
, che rappresenta l'ID univoco del client pubblicitario utilizzato nella dimensione dei reportAD_CLIENT_ID
. Se il camporeporting_dimension_id
è vuoto, AdClient non supporta i report.
AdUnit
- Il campo
status
è stato rinominato instate
. Inoltre, lo statoACTIVE
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 camponame
(dopo l'ultima barra). - Il campo
contentAdsSettings.backupOption
è stato rimosso. - Per il campo
type
sono stati limitati i valoriTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
eLINK
. - Verranno rimossi anche altri campi che sono già stati rimossi nell'interfaccia utente di AdSense:
custom_style
,saved_style_id
,mobile_content_ads_settings
efeed_ads_settings
.
Avviso
- Il metodo
delete
è stato rimosso. - Il campo
is_dismissible
è stato rimosso. - Il campo
locale
è stato rinominato inlanguage_code
.
CustomChannel
- Il campo
code
è stato rimosso. Questo valore è ancora disponibile alla fine del camponame
(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 indate
e cambiato da stringa di tipo a tipogoogle.type.Date
. - Il campo
payment_amount
e il campopayment_amount_currency_code
sono stati combinati in un singolo campopayment
(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
eMetadata.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 inaccount
. - Il campo
dimension
è stato rinominato indimensions
. - Il campo
metric
è stato rinominato inmetrics
. - Il campo
filter
è stato rinominato infilters
. - Il campo
sort
è stato rinominato inorder_by
. - Il campo
locale
è stato rinominato inlanguage_code
. - Il campo
currency
è stato rinominato incurrency_code
. - Ora puoi specificare diversi intervalli comuni con
date_range
(ad es.TODAY
,YESTERDAY
,MONTH_TO_DATE
,YEAR_TO_DATE
,LAST_7_DAYS
eLAST_30_DAYS
) oppure puoi specificarestart_date
eend_date
impostandodate_range
suCUSTOM
. - I campi
start_date
eend_date
sono stati modificati da stringa di tipo a tipogoogle.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 conreporting_time_zone
, che può avere uno di due valori:ACCOUNT_TIME_ZONE
oGOOGLE_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 inlimit
.
- Il campo
-
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 inlanguage_code
. - Il campo
start_index
è stato rimosso. - Il campo
max_results
è stato rimosso.
- Campi data aggiunti (
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.
Versione 1.4
Questa versione introduce le seguenti funzionalità:
- Ora puoi elencare i pagamenti del tuo account AdSense nella valuta corrispondente.
- Ora puoi ignorare un avviso chiamando il metodo
delete
, che lo nasconderà nell'API e nell'interfaccia web di AdSense. - La risposta al report ora include le date di inizio e di fine. Questo è importante
se utilizzi date relative durante la generazione di report (ad esempio
today
,yesterday
efirstDayOfMonth-1m
), la risposta ora include l'intervallo di date richiesto.
Problemi noti
Il campo currency
nei report non è supportato in questa release.
Versione 1.3
Questa versione introduce le seguenti funzionalità:
- Possibilità di recuperare gli avvisi.
- La possibilità di recuperare i metadati di metriche e dimensioni.
- Possibilità di eseguire report nel fuso orario locale dell'account.
Problemi noti
Il campo currency
nei report non è supportato in questa release.
Versione 1.2
Questa versione introduce le seguenti funzionalità:
- Possibilità di recuperare gli stili dell'annuncio.
- Possibilità di recuperare ed eseguire i report salvati definiti nel frontend.
Problemi noti
Il campo currency
nei report non è supportato in questa release.
Versione 1.1
Questa versione introduce le seguenti funzionalità:
- La possibilità di elencare gli account a cui l'utente ha accesso
- La possibilità di effettuare una chiamata GET su un account specifico
- La possibilità di effettuare chiamate GET sulle unità pubblicitarie e sui canali personalizzati
- La capacità di determinare i collegamenti tra unità pubblicitarie e canali personalizzati.
- I canali personalizzati contengono più dati sulle informazioni di targeting
Inoltre, ora puoi accedere ai dati dal tuo account predefinito o da un account specifico.
Problemi noti
Il campo currency
nei report non è supportato in questa release.
Versione 1
Questa è la prima versione dell'API. Include il supporto per il recupero di client di annunci, unità pubblicitarie, canali personalizzati, canali URL e per l'esecuzione di report.
Problemi noti
Il campo currency
nei report non è supportato in questa release.