En esta página, se incluyen las notas de la versión de la API de AdSense Management.
Versión 2
En esta versión, se presentan los siguientes cambios para quitar la funcionalidad obsoleta y alinear la API de AdSense Management con los estándares actuales de las APIs 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 funciones adicionales (compatibles con versiones anteriores) en lugar de que se lancen nuevas funcionalidades en versiones secundarias separadas.
2023-06-19
Pagos
- payments.list ahora muestra detalles sobre los pagos de editores premium.
2023-06-13
Informes
- Se agregaron las métricas
FUNNEL_REQUESTS
,FUNNEL_IMPRESSIONS
,FUNNEL_CLICKS
yFUNNEL_RPM
, que proporcionan información sobre el rendimiento de las unidades de anuncios que no son de anuncios (por ejemplo, unidades de búsquedas relacionadas).
2023-03-30
Informes
- Se agregó la dimensión
PAGE_URL
, que permite desglosar las métricas por URL de la página (con algunas advertencias, consulta Desglose de URL de página).
2022-09-21
AdUnits
- Se agregaron métodos de creación y aplicación de parches. Ten en cuenta que estos métodos solo se pueden utilizar en proyectos habilitados para el producto AdSense for Platforms.
CustomChannels
- Se agregaron métodos de creación, aplicación de parches y actualización. Ten en cuenta que estos métodos solo se pueden utilizar en proyectos habilitados para el producto AdSense for Platforms.
- 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 plataforma desglosar las métricas por cuentas de publicador (publicadores de host) y cuentas secundarias (publicadores de plataforma).
2022-05-03
AdClient
- Se agregó el método get.
Informes
- Se agregó el método getSaved.
UrlChannels
- 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.
AdClient
- Al igual que los cambios en la cuenta que se mencionaron anteriormente, la API ahora muestra los clientes de anuncios inactivos, con un campo
state
que indica el estado del cliente de anuncios.
2022-02-24
Pago
-
El formato de nombre de recurso se amplió para admitir recursos independientes para los ingresos de YouTube. Este cambio es anterior al lanzamiento en etapas de la experiencia mejorada de AdSense para los creadores de YouTube, en la que los ingresos de la plataforma se separarán en su propia cuenta de pagos. La información de pago de YouTube también se mostrará a través de la forma de lista de pagos una vez que tengas una cuenta de pagos exclusiva para los ingresos de YouTube.
Los ingresos de YouTube tendrán el siguiente formato de nombre de recurso:
- accounts/{account}/payments/youtube-unpaid por los ingresos no pagados (actuales) de YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd para obtener ingresos pagados de YouTube.
Nota: Los nombres de los recursos para los ingresos de AdSense no se modifican:- accounts/{account}/payments/unpaid for nopaid (currentes) de AdSense ingresos.
- accounts/{account}/payments/yyyy-MM-dd para obtener los ingresos pagados de AdSense.
2021-06-30
Informe
- Se agregaron las dimensiones
AD_FORMAT_NAME
yAD_FORMAT_CODE
, que indican el modo en que se muestra un anuncio a los usuarios en tu sitio (anuncio in-page, viñeta, etcétera). Ten en cuenta que la versión 1.4 tenía dimensiones (obsoletas) con los mismos nombres, pero con miembros diferentes. Las dos dimensiones agregadas en la v2 son distintas de aquellas que estaban presentes en la v1.4.
19/04/2021 (versión inicial)
General
- Se quitaron todos los métodos obsoletos de la versión v1.4. Se incluyen los métodos de recursos que no requerían un objeto
accountId
. En la versión 2,accountId
se especifica en el campoparent
. - Según los estándares de la API de Google, los recursos ahora se identifican mediante un campo
name
. Por ejemplo, el nombre de un AdClient tendría el siguiente aspecto:accounts/{accountId}/adclients/{adClientId}
. Además, en la versión 1.4, el ID del recurso se usaba como una 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. - Se quitó el campo
kind
de todos los recursos.
Cuenta
- El campo
name
se cambió adisplay_name
. - El campo
timezone
se cambió de una cadena a unagoogle.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 cuentas secundarias se puede generar en la v2 llamando alistChildAccounts
de forma recursiva.
AdClient
- 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 de anuncios como se usa en la dimensión de informesAD_CLIENT_ID
. Sireporting_dimension_id
está vacío, significa que AdClient no admite la generación de informes.
AdUnit
- Se cambió el nombre del campo
status
porstate
. Además, el estadoACTIVE
ya no indica si hubo actividad en esta unidad de anuncios durante los últimos siete días. En la v2, significa que el usuario activó la unidad de anuncios y puede publicar anuncios. - Se quitó el campo
code
. Este valor todavía 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
porlanguage_code
.
CustomChannel
- Se quitó el campo
code
. Este valor todavía 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 tipo string a tipogoogle.type.Date
. - Los campos
payment_amount
ypayment_amount_currency_code
se combinaron en un solo campopayment
(p.ej., "JPY 1,235", "USD 1,234.57", "£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 las propiedades de AdMob y YouTube ya no son compatibles. Además, la API solo admitirá datos de informes de 3 años anteriores.
- Se quitaron los recursos
Metadata.dimensions
yMetadata.metrics
. - Se agregaron métodos nuevos para generar una versión CSV del informe y se reemplazaron los parámetros de consulta de la versión 1.4. Nota: Para la compresión, puedes usar el encabezado HTTP "Accept-Encoding: gzip".
-
Algunos campos se modificaron durante la generación de informes ad hoc.
- Se cambió el nombre del campo
account_id
poraccount
. - Se cambió el nombre del campo
dimension
pordimensions
. - Se cambió el nombre del campo
metric
pormetrics
. - Se cambió el nombre del campo
filter
porfilters
. - Se cambió el nombre del campo
sort
pororder_by
. - Se cambió el nombre del campo
locale
porlanguage_code
. - Se cambió el nombre del campo
currency
porcurrency_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 especificar unstart_date
y unend_date
si establecesdate_range
enCUSTOM
. - Los campos
start_date
yend_date
se cambiaron de tipo string a tipogoogle.type.Date
. Nota: Como resultado, las palabras clave relativas de fecha (p.ej., "today-6d") ya no son compatibles. - El campo booleano
use_timezone_reporting
se reemplazó 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 versión 2 esACCOUNT_TIME_ZONE
, lo que difiere de la versión predeterminada en la v1.4. - Se quitó el campo
start_index
. - Se cambió el nombre del campo
max_results
porlimit
.
- Se cambió el nombre del campo
-
Se modificaron algunos campos durante la generación del informe guardado.
- 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
porlanguage_code
. - Se quitó el campo
start_index
. - Se quitó el campo
max_results
.
- Se agregaron campos de fecha (
SavedAdStyle
- Dado que ya se quitó de la IU de AdSense,
SavedAdStyle
se quitó.
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 valor booleano que representa si se habilitaron los anuncios automáticos en un sitio en particular.
Versión 1.4
Esta versión presenta las siguientes funciones:
- Ahora puedes mostrar los pagos de tu cuenta de AdSense en la moneda correspondiente.
- Ahora puedes descartar una alerta llamando 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 cuando generas informes (como
today
,yesterday
ofirstDayOfMonth-1m
), la respuesta ahora incluirá el período que solicitaste.
Errores conocidos
El campo currency
de los informes no es compatible con esta versión.
Versión 1.3
Esta versión presenta las siguientes funciones:
- 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
de los informes no es compatible con esta versión.
Versión 1.2
Esta versión presenta las siguientes funciones:
- La capacidad de recuperar estilos de anuncio
- La capacidad de recuperar y ejecutar los informes guardados definidos en el frontend.
Errores conocidos
El campo currency
de los informes no es compatible con esta versión.
Versión 1.1
Esta versión presenta las siguientes funciones:
- La capacidad de enumerar las cuentas a las que tiene acceso el usuario
- La capacidad de realizar una llamada GET en una cuenta específica
- La capacidad de realizar llamadas GET en unidades de anuncios y canales personalizados
- La capacidad de determinar las conexiones entre las unidades de anuncios y los canales personalizados
- Los canales personalizados contienen más datos sobre la segmentación
Además, ahora puedes acceder a los datos con tu cuenta predeterminada o una cuenta específica.
Errores conocidos
El campo currency
de los informes no es compatible con esta versión.
Versión 1
Esta es la primera versión de la API. Incluye compatibilidad con la recuperación de clientes de anuncios, unidades de anuncios, canales personalizados, canales de URL y la ejecución de informes.
Errores conocidos
El campo currency
de los informes no es compatible con esta versión.