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

Notas de versión

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 y AD_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, la 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 cliente se vería como accounts/{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 campo reporting_dimension_id en varios recursos.
El campo kind se quitó de todos los recursos.

Cuenta

Se cambió el campo name a display_name.
El campo timezone cambió de una string a un 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 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 personalizado listChildAccounts. El árbol completo de la cuenta secundaria se puede generar en la versión 2 llamando a listChildAccounts 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 campo reporting_dimension_id, que representa el ID único del cliente del anuncio como se usa en la dimensión de informes AD_CLIENT_ID. Si reporting_dimension_id está vacío, el cliente 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 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 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 quitan otros campos que ya se quitaron 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.

Canal personalizado

Se quitó el campo code. Este valor aún se puede encontrar al final del campo name (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 a date y se cambió de una string de tipo a google.type.Date.
Los campos payment_amount y payment_amount_currency_code se combinaron en un solo campo payment (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 y Metadata.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 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 start_date y end_date si configuras date_range en CUSTOM.
- Los campos start_date y end_date se cambiaron de string de tipo a google.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 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 v2 es ACCOUNT_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 a limit.
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 a language_code.
- Se quitó el campo start_index.
- Se quitó el campo max_results.

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 o NEEDS_ATTENTION.
El campo auto_ads_enabled es un booleano que representa si los anuncios automáticos se habilitaron en un sitio en particular.