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

Notas de la versión

En esta página, se incluyen 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 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 (compatibles con versiones anteriores), en lugar de que las funciones nuevas se lancen en versiones secundarias independientes.

2024-04-03

PolicyIssues

Se agregó una nueva colección para denunciar incumplimientos de políticas y advertencias actuales en una cuenta.

2023-06-19

Pagos

payments.list ahora muestra detalles sobre los pagos de los editores 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ú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 el Desglose de la URL de página).

2022-09-21

AdUnits

Se agregaron métodos create y parche. Ten en cuenta que solo los proyectos habilitados para el producto AdSense for Platforms pueden utilizar estos métodos.

CustomChannels

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 for Platforms pueden utilizar 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 plataforma desglosar las métricas por cuentas de publicador (publicadores 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 indicaron anteriormente, la API muestra los clientes de anuncios inactivos, con un campo state que indica el estado del cliente del anuncio.

2022-02-24

Pago

Se amplió el formato de nombre de recurso para 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 mostrará desde 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 recursos para los ingresos de AdSense no se modifican:
- accounts/{account}/payments/unpaid for nopaid (current) de AdSense.
- accounts/{account}/payments/yyyy-MM-dd para obtener 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 (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 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, accountId se especifica en el campo parent.
Según los estándares de las APIs 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, se usaba el ID de recurso como una dimensión de informes, pero en la versión 2 ese valor ahora está disponible a través del 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 se cambió de una cadena a una google.type.TimeZone.
Se cambió el campo creation_time (tipo int64) a create_time (tipo google.protobuf.Timestamp).
Se agregó un campo pending_tasks, que es una lista de tareas pendientes que deben completarse 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. Se puede lograr una funcionalidad similar en la versión 2 con el método personalizado listChildAccounts. En la versión 2, se puede generar el árbol de cuentas secundarias completo si se llama a listChildAccounts de manera recursiva.

AdClient

Se quitó el campo arc_opt_in, dado 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, significa que AdClient no admite la generación de informes.

AdUnit

Se cambió el nombre del campo status por 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 se quitaron de 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 por 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, dado que ya se quitó de la IU de AdSense.

Pago

Se cambió el nombre del campo payment_date por date y se cambió de tipo string al tipo google.type.Date.
Los campos payment_amount y payment_amount_currency_code se combinaron en un solo campo payment (p.ej., "JPY 1,235", "USD 1,234.57" o "£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 se admiten. Además, la API solo admitirá datos de informes de 3 años de antigüedad.
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 usar 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 por account.
- Se cambió el nombre del campo dimension por dimensions.
- Se cambió el nombre del campo metric por metrics.
- Se cambió el nombre del campo filter por filters.
- Se cambió el nombre del campo sort por order_by.
- Se cambió el nombre del campo locale por language_code.
- Se cambió el nombre del campo currency por 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 start_date y end_date estableciendo date_range en CUSTOM.
- Los campos start_date y end_date se cambiaron de tipo string al tipo google.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ó por reporting_time_zone, que puede tener uno de dos valores: ACCOUNT_TIME_ZONE o GOOGLE_TIME_ZONE (lo que significa PST/PDT). El valor predeterminado en la versión 2 es ACCOUNT_TIME_ZONE, que difiere del predeterminado en la versión 1.4.
- Se quitó el campo start_index.
- Se cambió el nombre del campo max_results por limit.
Se modificaron algunos campos durante 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 por language_code.
- Se quitó el campo start_index.
- Se quitó el campo max_results.

SavedAdStyle

SavedAdStyle se quitó 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 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.