Notas de versión

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

ClienteAd

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.

Versión 1.4

En esta versión, se presenta la siguiente funcionalidad:

  • Ahora puede enumerar los pagos de su cuenta de AdSense en la moneda correspondiente.
  • Ahora puedes descartar una alerta si llamas 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 al generar informes (como today, yesterday, firstDayOfMonth-1m), la respuesta ahora incluye el período que solicitaste.

Errores conocidos

El campo currency en los informes no es compatible con esta versión.

Versión 1.3

En esta versión, se presenta la siguiente funcionalidad:

  • 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 en los informes no es compatible con esta versión.

Versión 1.2

En esta versión, se presenta la siguiente funcionalidad:

  • La capacidad de recuperar estilos de anuncios
  • La capacidad de recuperar y ejecutar los informes guardados definidos en el frontend.

Errores conocidos

El campo currency en los informes no es compatible con esta versión.

Versión 1.1

En esta versión, se presenta la siguiente funcionalidad:

Además, ahora puede acceder a los datos con su cuenta predeterminada o con una cuenta específica.

Errores conocidos

El campo currency en los informes no es compatible con esta versión.

Versión 1

Esta es la primera versión de la API. Incluye compatibilidad para recuperar clientes de anuncios, bloques de anuncios, canales personalizados, canales de URL y la ejecución de informes.

Errores conocidos

El campo currency en los informes no es compatible con esta versión.