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

Notas de la versión

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

Versión 2

Esta versión presenta 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 funciones adicionales (retrocompatibles) en lugar de funciones nuevas que se lanzarán en versiones secundarias independientes.

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, las reglamentaciones o las preferencias 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 de política y las advertencias actuales de una cuenta.

2023-06-19

Pagos

payments.list ahora muestra detalles sobre los pagos de 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 relacionadas).

2023-03-30

Informes

Se agregó la dimensión PAGE_URL, que permite que las métricas se desglosen por URL de la página (con algunas excepciones, consulta Desglose de la URL de la página).

2022-09-21

AdUnits

Se agregaron métodos de creación y corrección. Ten en cuenta que solo los proyectos habilitados para el producto AdSense para plataformas pueden usar estos métodos.

CustomChannels

Se agregaron métodos de creación, parcheo 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 que los publicadores de host y de plataforma desglosen las métricas por las cuentas de su publicador (publicadores de host) y por las 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

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

AdClient

Al igual que con los cambios en la cuenta anteriores, la API ahora 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 de nombre de recurso para admitir recursos separados para los ingresos de YouTube. Este cambio se realiza antes del lanzamiento gradual 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 mostrará desde el método de la 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 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 cambian:
- accounts/{account}/payments/unpaid para los ingresos de AdSense no pagados (actuales).
- accounts/{account}/payments/yyyy-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, en una 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 que se agregaron 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 la API de Google, los recursos ahora se identifican con un campo name. Por ejemplo, el nombre de un AdClient se vería como accounts/{accountId}/adclients/{adClientId}. Además, en la v1.4, el ID de recurso se usaba como una dimensión de informes, pero en la v2, ese valor ahora está disponible a través de un campo reporting_dimension_id en varios recursos.
El campo kind se quitó de todos los recursos.

Cuenta

El campo name cambió a display_name.
El campo timezone se 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 pueden estar relacionadas con tu perfil de facturación o verificación telefónica.
Se quitó el campo sub_accounts. Se puede lograr una funcionalidad similar en la versión 2 con el método personalizado listChildAccounts. Para generar el árbol completo de cuentas secundarias en la versión 2, llama a listChildAccounts de forma recursiva.

AdClient

Se quitó el campo arc_opt_in, ya que ya 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 como se usa en la dimensión de informes AD_CLIENT_ID. Si reporting_dimension_id está vacío, entonces 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ó la unidad de anuncios y puede publicar anuncios.
Se quitó el campo code. Este valor se puede encontrar al final del campo name (después de la última barra diagonal).
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 no se muestran 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 se puede encontrar al final del campo name (después de la última barra diagonal).
Se quitó el campo targeting_info, ya que ya se quitó de la IU de AdSense.

Pago

Se cambió el nombre del campo payment_date a date y se cambió de tipo de cadena a tipo google.type.Date.
El campo payment_amount y el campo payment_amount_currency_code se combinaron en un solo campo payment (p.ej., "¥1,235 JPY", "$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 ya no se admiten las propiedades de AdMob ni de YouTube. Además, la API solo admitirá datos de informes de 3 años hacia atrás.
Se quitaron los recursos Metadata.dimensions y Metadata.metrics.
Se agregaron métodos nuevos para generar una versión CSV del informe, que reemplaza 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".
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 puedes especificar un start_date y un end_date configurando date_range en CUSTOM.
- Los campos start_date y end_date cambiaron de tipo de cadena a tipo google.type.Date. Nota: Como resultado, las palabras clave de fecha relativas (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 v2 es ACCOUNT_TIME_ZONE, que difiere del valor predeterminado en v1.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 ya se quitó de la IU de AdSense.

Sitio

Se agregó Sites 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 o 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.