Se usó la API de Cloud Translation para traducir esta página.

Notas de la versión

En esta página, se proporcionan las notas de la versión de la API de AdSense Management.

Versión 2

Esta versión introduce 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 versiones de las APIs de Google, esta versión se actualizará con el tiempo para incluir funciones adicionales (retrocompatibles) en lugar de que se lancen funciones nuevas en versiones secundarias separadas.

2025-10-02

Informes

Se agregó la dimensión TRAFFIC_SOURCE, que permite desglosar las métricas por fuente de tráfico (p.ej., "Google", "Bing", "Facebook", "Otro"). Para obtener más información, consulta Desglose de las fuentes de tráfico.

2025-05-06

PolicyIssues

El campo policyTopics[].must_fix obsoleto (consulta la actualización anterior) ahora siempre se establecerá en false.

2025-02-24

PolicyIssues

Se agregó un campo policyTopics[].type para identificar si un tema de política representa un problema relacionado con las políticas, un problema relacionado con las reglamentaciones o una preferencia del anunciante. Esto reemplaza a policyTopics[].must_fix, que ahora se marca como un campo obsoleto.

2024-04-03

PolicyIssues

Se agregó una nueva colección para informar sobre los incumplimientos y las advertencias actuales de las políticas presentes en una cuenta.

2023-06-19

Pagos

payments.list ahora devuelve detalles sobre los pagos para los publicadores premium.

2023-06-13

Informes

Se agregaron las métricas FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS y FUNNEL_RPM, que proporcionan información sobre el rendimiento de las unidades que no son de anuncios (por ejemplo, las unidades de búsqueda relacionada).

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 la URL de la página).

2022-09-21

AdUnits

Se agregaron los métodos create y patch. Ten en cuenta que estos métodos solo pueden usarlos los proyectos habilitados para el producto AdSense para plataformas.

CustomChannels

Se agregaron los métodos create, patch y update. Ten en cuenta que estos métodos solo pueden usarlos los proyectos habilitados para el producto AdSense para plataformas.
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 las cuentas de sus publicadores (publicadores de host) y por las subcuentas (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

La API ahora devuelve las cuentas inactivas con un campo state que indica el estado de la cuenta.

AdClient

Al igual que con los cambios en la cuenta, la API ahora devuelve los clientes de anuncios inactivos con un campo state que indica el estado del cliente de anuncios.

2022-02-24

Pago

Se extendió el formato del nombre del recurso para admitir recursos separados para las ganancias de YouTube. Este cambio se realiza antes del lanzamiento gradual de la experiencia mejorada de AdSense para los creadores de YouTube, en la que los ingresos de YouTube se separarán en su propia cuenta de pagos. La información de pagos de YouTube también se devolverá desde el método 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 del recurso:
- accounts/{account}/payments/youtube-unpaid para los ingresos de YouTube pendientes de pago (actuales)
- accounts/{account}/payments/youtube-yyyy-MM-dd para los ingresos pagados de YouTube
Nota: Los nombres de los recursos para los ingresos de AdSense no cambiaron:
- accounts/{account}/payments/unpaid para los ingresos (actuales) no pagados de AdSense.
- accounts/{account}/payments/aaaa-MM-dd para los ingresos pagados de AdSense

2021-06-30

Informe

Se agregaron las dimensiones AD_FORMAT_NAME y AD_FORMAT_CODE, que indican la forma en que se muestra un anuncio a los usuarios en tu sitio (en la página, viñeta, etcétera). Ten en cuenta que la versión 1.4 tenía dimensiones (obsoletas) con los mismos nombres, pero miembros diferentes. Las dos dimensiones agregadas en la versión 2 son distintas de las que estaban presentes en la versión 1.4.

19-04-2021 (versión 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 versión 2, el accountId se especifica en el campo parent.
Según los estándares de las APIs de Google, los recursos ahora se identifican con un campo name. Por ejemplo, el nombre de un AdClient se vería así: accounts/{accountId}/adclients/{adClientId}. Además, en la versión 1.4, el ID del recurso se usaba como dimensión de informes, pero en la versión 2, ese valor ahora está disponible a través de un campo reporting_dimension_id en varios recursos.
Se quitó el campo kind de todos los recursos.

Cuenta

El campo name se cambió a display_name.
El campo timezone cambió de una cadena a un google.type.TimeZone.
El campo creation_time (tipo int64) se cambió a create_time (tipo google.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 de una cuenta nueva. Por ejemplo, las tareas podrían estar relacionadas con tu perfil de facturación o la verificación telefónica.
Se quitó el campo sub_accounts. En la versión 2, se puede lograr una funcionalidad similar con el método personalizado listChildAccounts. El árbol completo de la cuenta secundaria se puede generar en la versión 2 llamando a listChildAccounts de forma recursiva.

AdClient

Se quitó el campo arc_opt_in, ya que se quitó de la IU de AdSense.
El campo supports_reporting se reemplaza por el campo reporting_dimension_id, que representa el ID único del cliente de anuncios tal como se usa en la dimensión de informes AD_CLIENT_ID. Si reporting_dimension_id está vacío, el objeto AdClient no admite informes.

AdUnit

Se cambió el nombre del campo status a state. Además, el estado ACTIVE ya no indica si hubo actividad en esta unidad de anuncios en los últimos siete días. En la versión 2, significa que el usuario activó el bloque de anuncios y que este puede publicar anuncios.
Se quitó el campo code. Este valor aún se puede encontrar al final del campo name (después de la última barra).
Se quitó el campo contentAdsSettings.backupOption.
El campo type se restringió a los valores TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT y LINK.
También se quitaron otros campos que ya se habían quitado en la IU de AdSense: custom_style, saved_style_id, mobile_content_ads_settings y feed_ads_settings.

Alerta

Se quitó el método delete.
Se quitó el campo is_dismissible.
Se cambió el nombre del campo locale a language_code.

CustomChannel

Se quitó el campo code. Este valor aún se puede encontrar al final del campo name (después de la última barra).
El campo targeting_info se quitó porque ya se había quitado de la IU de AdSense.

Pago

Se cambió el nombre del campo payment_date a date y se modificó su tipo de cadena a google.type.Date.
Los campos payment_amount y payment_amount_currency_code se combinaron en un solo campo payment (p.ej., "USD 1,235", "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 y YouTube. Además, la API solo admitirá datos de informes de los últimos 3 años.
Se quitaron los recursos Metadata.dimensions y Metadata.metrics.
Se agregaron métodos nuevos para generar una versión CSV del informe, que reemplazan los parámetros de consulta en la versión 1.4. Nota: Para la compresión, puedes seguir usando el encabezado HTTP "Accept-Encoding: gzip".
Se cambiaron algunos campos en la generación de informes ad hoc.
- Se cambió el nombre del campo account_id a account.
- Se cambió el nombre del campo dimension a dimensions.
- Se cambió el nombre del campo metric a metrics.
- Se cambió el nombre del campo filter a filters.
- Se cambió el nombre del campo sort a order_by.
- Se cambió el nombre del campo locale a language_code.
- Se cambió el nombre del campo currency a currency_code.
- Ahora puedes especificar varios rangos comunes con date_range (p.ej., TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS y LAST_30_DAYS), o bien puedes especificar un start_date y un end_date configurando date_range como CUSTOM.
- Los campos start_date y end_date se cambiaron del tipo de cadena al tipo google.type.Date. Nota: Como resultado, las palabras clave de fecha relativa (p.ej., "today-6d") ya no se admiten.
- El campo booleano use_timezone_reporting se reemplazó por reporting_time_zone, que puede tener uno de dos valores: ACCOUNT_TIME_ZONE o GOOGLE_TIME_ZONE (que significa PST/PDT). El valor predeterminado en la versión 2 es ACCOUNT_TIME_ZONE, que difiere del valor predeterminado en la versión 1.4.
- Se quitó el campo start_index.
- Se cambió el nombre del campo max_results a limit.
Se cambiaron algunos campos 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 a language_code.
- Se quitó el campo start_index.
- Se quitó el campo max_results.

SavedAdStyle

Se quitó SavedAdStyle, ya que se había quitado de la IU de AdSense.

Sitio

Sites se agregaron para recuperar datos sobre los sitios web que agregaste a tu cuenta de AdSense.
El campo state representa si el sitio se encuentra en alguno de los siguientes estados: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
El campo auto_ads_enabled es un valor booleano que representa si se habilitaron los anuncios automáticos en un sitio en particular.