En esta página, se proporcionan notas de la versión de la API de AdSense Management.
Versión 2
En esta versión, se introducen los siguientes cambios para quitar la funcionalidad obsoleta y alinear la API de AdSense Management con los estándares actuales de la API de Google. Según el esquema de control de versiones de la API de Google, esta versión se actualizará con el tiempo para incluir más funciones (compatibles con versiones anteriores) en lugar de lanzar funciones nuevas en versiones secundarias independientes.
2022-09-21
Bloques de anuncios
- Se agregaron métodos de creación y aplicación de parches. Ten en cuenta que solo los proyectos habilitados para el producto AdSense para plataformas pueden usar estos métodos.
Canales personalizados
- Se agregaron métodos de creación, aplicación de parches y actualización. Ten en cuenta que solo los proyectos habilitados para el producto AdSense para plataformas pueden usar estos métodos.
- Se agregó el campo activo al recurso.
Cuentas
- Se agregó el método getAdBlockingRecoveryTag.
2022-08-25
Informes
- Se agregó la dimensión
HOSTED_AD_CLIENT_ID
, que permite a los publicadores de host y de plataforma desglosar las métricas por cuenta de publicador (editor de host) y por cuenta secundaria (publicadores de plataforma).
2022-05-03
ClienteAd
- Se agregó el método get.
Informes
- Se agregó el método getSaved.
CanalesURL
- Se agregó el método get.
2022-03-31
Cuenta
- Ahora la API muestra las cuentas inactivas, con un campo
state
que indica el estado de la cuenta.
ClienteAd
- Al igual que los cambios de la cuenta anteriores, ahora la API muestra clientes de anuncios inactivos, con un campo
state
que indica el estado del cliente de anuncios.
2022-02-24
Pago
-
Se amplió el formato del nombre del recurso a fin de admitir recursos independientes para los ingresos de YouTube. Este cambio es anterior al lanzamiento en etapas de la experiencia mejorada de AdSense para creadores de YouTube, en la que los ingresos de YouTube se separarán en su propia cuenta de pagos. La información de pago de YouTube también se devolverá de la forma de lista de pagos, una vez que tengas una cuenta de pagos dedicada para los ingresos de YouTube.
Los ingresos de YouTube tendrán el siguiente formato de nombre de recurso:
- accounts/{account}/payments/youtube-unpaid por ingresos no pagados (actuales) de YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd para los ingresos de YouTube pagados.
Nota: Los nombres de recursos de los ingresos de AdSense no se modifican:- accounts/{account}/payments/unpaid por ingresos no pagados (actuales) de AdSense.
- accounts/{account}/payments/yyyy-MM-dd para los ingresos de AdSense pagos.
2021-06-30
Informe
- Se agregaron las dimensiones
AD_FORMAT_NAME
yAD_FORMAT_CODE
, que indican la forma en que se muestra un anuncio a los usuarios en su sitio (anuncio in-page, viñeta, etcétera). Ten en cuenta que la v1.4 tenía dimensiones (obsoletas) con los mismos nombres, pero con miembros diferentes. Las dos dimensiones agregadas en la v2 son distintas de las que estaban presentes en la v1.4.
19 de abril de 2021 (lanzamiento inicial)
General
- Se quitaron todos los métodos obsoletos de la versión 1.4. Esto incluye los métodos de recursos que no requerían un
accountId
. En la v2, laaccountId
se especifica en el campoparent
. - Según los estándares de la API de Google, los recursos ahora se identifican con un campo
name
. Por ejemplo, el nombre de un cliente se vería comoaccounts/{accountId}/adclients/{adClientId}
. Además, en la versión 1.4, el ID de recurso se usaba como dimensión de informes, pero en la versión 2, ese valor ahora está disponible a través de un camporeporting_dimension_id
en varios recursos. - El campo
kind
se quitó de todos los recursos.
Cuenta
- Se cambió el campo
name
adisplay_name
. - El campo
timezone
cambió de una string a ungoogle.type.TimeZone
. - Se cambió el campo
creation_time
(tipo int64) acreate_time
(tipogoogle.protobuf.Timestamp
). - Se agregó un campo
pending_tasks
que es una lista de tareas pendientes que se deben completar como parte del proceso de registro para una cuenta nueva. Por ejemplo, las tareas pueden estar relacionadas con tu perfil de facturación o la verificación telefónica. - Se quitó el campo
sub_accounts
. Se puede lograr una funcionalidad similar en la v2 con el método personalizadolistChildAccounts
. El árbol completo de la cuenta secundaria se puede generar en la versión 2 llamando alistChildAccounts
de forma recurrente.
ClienteAd
- Se quitó el campo
arc_opt_in
porque ya se quitó de la IU de AdSense. - El campo
supports_reporting
se reemplaza por el camporeporting_dimension_id
, que representa el ID único del cliente del anuncio como se usa en la dimensión de informesAD_CLIENT_ID
. Sireporting_dimension_id
está vacío, el cliente no admite informes.
AdUnit
- Se cambió el nombre del campo
status
astate
. Además, el estadoACTIVE
ya no indica si hubo actividad en este bloque de anuncios en los últimos siete días. En la v2, significa que el usuario activó el bloque de anuncios y este puede publicar anuncios. - Se quitó el campo
code
. Este valor aún se puede encontrar al final del camponame
(después de la última barra diagonal). - Se quitó el campo
contentAdsSettings.backupOption
. - El campo
type
se restringió a los valoresTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
yLINK
. - También se quitan otros campos que ya se quitaron en la IU de AdSense:
custom_style
,saved_style_id
,mobile_content_ads_settings
yfeed_ads_settings
.
Alerta
- Se quitó el método
delete
. - Se quitó el campo
is_dismissible
. - Se cambió el nombre del campo
locale
alanguage_code
.
Canal personalizado
- Se quitó el campo
code
. Este valor aún se puede encontrar al final del camponame
(después de la última barra diagonal). - Se quitó el campo
targeting_info
porque ya se quitó de la IU de AdSense.
Pago
- Se cambió el nombre del campo
payment_date
adate
y se cambió de una string de tipo agoogle.type.Date
. - Los campos
payment_amount
ypayment_amount_currency_code
se combinaron en un solo campopayment
(p.ej., JPY 1,235 JPY, USD 1,234.57, GBP 87.65).
Informe
- Con la versión 2, los datos de informes de la API de AdSense Management ahora se alinean con la IU de AdSense. Esto significa que ya no se admiten las propiedades de AdMob ni de YouTube. Además, la API solo admitirá datos de informes de 3 años atrás.
- Se quitaron los recursos
Metadata.dimensions
yMetadata.metrics
. - Se agregaron métodos nuevos para generar una versión CSV del informe y reemplazar los parámetros de consulta de la versión 1.4. Nota: Para la compresión, puedes seguir usando el encabezado HTTP "Accept-Encoding: gzip".
-
Algunos campos se modificaron en la generación de informes ad hoc.
- Se cambió el nombre del campo
account_id
aaccount
. - Se cambió el nombre del campo
dimension
adimensions
. - Se cambió el nombre del campo
metric
ametrics
. - Se cambió el nombre del campo
filter
afilters
. - Se cambió el nombre del campo
sort
aorder_by
. - Se cambió el nombre del campo
locale
alanguage_code
. - Se cambió el nombre del campo
currency
acurrency_code
. - Ahora puedes especificar varios rangos comunes con
date_range
(p.ej.,TODAY
,YESTERDAY
,MONTH_TO_DATE
,YEAR_TO_DATE
,LAST_7_DAYS
yLAST_30_DAYS
), o puedes especificarstart_date
yend_date
si configurasdate_range
enCUSTOM
. - Los campos
start_date
yend_date
se cambiaron de string de tipo agoogle.type.Date
. Nota: Como resultado, las palabras clave de fecha relativa (p.ej., "today-6d") ya no son compatibles. - Se reemplazó el campo booleano
use_timezone_reporting
porreporting_time_zone
, que puede tener uno de dos valores:ACCOUNT_TIME_ZONE
oGOOGLE_TIME_ZONE
(que significa PST/PDT). El valor predeterminado en la v2 esACCOUNT_TIME_ZONE
, que difiere del valor predeterminado en la v1.4. - Se quitó el campo
start_index
. - Se cambió el nombre del campo
max_results
alimit
.
- Se cambió el nombre del campo
-
Algunos campos se cambiaron en la generación de informes guardados.
- Se agregaron campos de fecha (
date_range
,start_date
,end_date
,reporting_time_zone
). - Se agregó un campo
currency_code
. - Se cambió el nombre del campo
locale
alanguage_code
. - Se quitó el campo
start_index
. - Se quitó el campo
max_results
.
- Se agregaron campos de fecha (
Estilo de anuncio guardado
- Se quitó
SavedAdStyle
porque ya se quitó de la IU de AdSense.
Sitio
-
Se agregaron
Sites
para recuperar datos sobre los sitios web que agregaste a tu cuenta de AdSense. - El campo
state
representa si el sitio tiene alguno de los siguientes estados:REQUIRES_REVIEW
,GETTING_READY
,READY
oNEEDS_ATTENTION
. - El campo
auto_ads_enabled
es un booleano que representa si los anuncios automáticos se habilitaron en un sitio en particular.
Versión 1.4
En esta versión, se presenta la siguiente funcionalidad:
- Ahora puede enumerar los pagos de su cuenta de AdSense en la moneda correspondiente.
- Ahora puedes descartar una alerta si llamas al método
delete
, que la ocultará en la API y en la interfaz web de AdSense. - La respuesta del informe ahora incluye las fechas de inicio y finalización. Esto es importante si usas fechas relativas al generar informes (como
today
,yesterday
,firstDayOfMonth-1m
), la respuesta ahora incluye el período que solicitaste.
Errores conocidos
El campo currency
en los informes no es compatible con esta versión.
Versión 1.3
En esta versión, se presenta la siguiente funcionalidad:
- La capacidad de recuperar alertas.
- La capacidad de recuperar metadatos de métricas y dimensiones.
- La capacidad de ejecutar informes en la zona horaria local de la cuenta.
Errores conocidos
El campo currency
en los informes no es compatible con esta versión.
Versión 1.2
En esta versión, se presenta la siguiente funcionalidad:
- La capacidad de recuperar estilos de anuncios
- La capacidad de recuperar y ejecutar los informes guardados definidos en el frontend.
Errores conocidos
El campo currency
en los informes no es compatible con esta versión.
Versión 1.1
En esta versión, se presenta la siguiente funcionalidad:
- La capacidad de enumerar cuentas a las que el usuario tiene acceso
- Capacidad de realizar una llamada GET a una cuenta específica
- La capacidad de realizar llamadas GET a bloques de anuncios y canales personalizados
- La capacidad de determinar las conexiones entre los bloques de anuncios y los canales personalizados
- Los canales personalizados contienen más datos sobre la información de orientación.
Además, ahora puede acceder a los datos con su cuenta predeterminada o con una cuenta específica.
Errores conocidos
El campo currency
en los informes no es compatible con esta versión.
Versión 1
Esta es la primera versión de la API. Incluye compatibilidad para recuperar clientes de anuncios, bloques de anuncios, canales personalizados, canales de URL y la ejecución de informes.
Errores conocidos
El campo currency
en los informes no es compatible con esta versión.