Notas de la versión

En esta página, se incluyen las 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 las APIs 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 se lancen nuevas funcionalidades en versiones secundarias separadas.

2023-06-19

Pagos

  • payments.list ahora muestra detalles sobre los pagos de 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 de anuncios que no son de anuncios (por ejemplo, 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 Desglose de URL de página).

2022-09-21

AdUnits

  • Se agregaron métodos de creación y aplicación de parches. Ten en cuenta que estos métodos solo se pueden utilizar en proyectos habilitados para el producto AdSense for Platforms.

CustomChannels

  • Se agregaron métodos de creación, aplicación de parches y actualización. Ten en cuenta que estos métodos solo se pueden utilizar en proyectos habilitados para el producto AdSense for Platforms.
  • 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 de 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

AdClient

2022-02-24

Pago

  • El formato de nombre de recurso se amplió para admitir recursos independientes para los ingresos de YouTube. Este cambio es anterior al lanzamiento en etapas de la experiencia mejorada de AdSense para los creadores de YouTube, en la que los ingresos de la plataforma se separarán en su propia cuenta de pagos. La información de pago de YouTube también se mostrará a través de 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 los recursos para los ingresos de AdSense no se modifican:
    • accounts/{account}/payments/unpaid for nopaid (currentes) de AdSense ingresos.
    • accounts/{account}/payments/yyyy-MM-dd para obtener los ingresos pagados de AdSense.

2021-06-30

Informe

  • Se agregaron las dimensiones AD_FORMAT_NAME y AD_FORMAT_CODE, que indican el modo en que se muestra un anuncio a los usuarios en tu sitio (anuncio 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 v2 son distintas de aquellas que estaban presentes en la v1.4.

19/04/2021 (versión inicial)

General

  • Se quitaron todos los métodos obsoletos de la versión v1.4. Se incluyen los métodos de recursos que no requerían un objeto accountId. En la versión 2, accountId se especifica en el campo parent.
  • Según los estándares de la API 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, el ID del recurso se usaba como una 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 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 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 cuentas secundarias se puede generar en la v2 llamando a listChildAccounts de forma recursiva.

AdClient

  • 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 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 durante los últimos siete días. En la v2, significa que el usuario activó la unidad de anuncios y puede publicar anuncios.
  • Se quitó el campo code. Este valor todavía 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 por language_code.

CustomChannel

  • Se quitó el campo code. Este valor todavía 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 tipo string a 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", "£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 son compatibles. Además, la API solo admitirá datos de informes de 3 años anteriores.
  • Se quitaron los recursos Metadata.dimensions y Metadata.metrics.
  • Se agregaron métodos nuevos para generar una versión CSV del informe y se reemplazaron los parámetros de consulta de la versión 1.4. Nota: Para la compresión, puedes usar el encabezado HTTP "Accept-Encoding: gzip".
  • Algunos campos se modificaron durante 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 puedes especificar un start_date y un end_date si estableces date_range en CUSTOM.
    • Los campos start_date y end_date se cambiaron de tipo string a 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 (que significa PST/PDT). El valor predeterminado en la versión 2 es ACCOUNT_TIME_ZONE, lo que difiere de la versión predeterminada en la v1.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 del informe guardado.
    • 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

  • Dado que ya se quitó de la IU de AdSense, SavedAdStyle se quitó.

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.

Versión 1.4

Esta versión presenta las siguientes funciones:

  • Ahora puedes mostrar los pagos de tu cuenta de AdSense en la moneda correspondiente.
  • Ahora puedes descartar una alerta llamando 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 cuando generas informes (como today, yesterday o firstDayOfMonth-1m), la respuesta ahora incluirá el período que solicitaste.

Errores conocidos

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

Versión 1.3

Esta versión presenta las siguientes funciones:

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

Versión 1.2

Esta versión presenta las siguientes funciones:

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

Errores conocidos

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

Versión 1.1

Esta versión presenta las siguientes funciones:

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

Errores conocidos

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

Versión 1

Esta es la primera versión de la API. Incluye compatibilidad con la recuperación de clientes de anuncios, unidades de anuncios, canales personalizados, canales de URL y la ejecución de informes.

Errores conocidos

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