La nueva API de informes de Search Ads 360 ya está disponible. Únete al grupo de Google searchads-api-announcements para mantenerte al tanto de las próximas mejoras y lanzamientos.
Hay versiones principales y secundarias, con el formato vMAJOR_MINOR. Por ejemplo, v0_0 es la primera versión principal y v0_1 es la primera versión secundaria. El sufijo del número de versión indica el tipo de versión: para las versiones principales, siempre es cero, y para las versiones secundarias, siempre es mayor que cero.
Versiones principales
Las versiones principales introducen cambios rotundos, es decir, cambios que no son compatibles con versiones anteriores.
Cada versión principal tiene un extremo separado, por ejemplo:
Cuando actualices de una versión principal a otra, es posible que debas cambiar tu código antes de cambiar al nuevo extremo de la versión principal.
Si usas una biblioteca cliente, debes actualizarla a la versión más reciente. Las nuevas versiones principales proporcionan una guía de migración para ayudarte a corregir los cambios rotundos en tu código.
Estos son algunos ejemplos de cambios rotundos:
Quitar o cambiar el nombre de un servicio, una interfaz, un campo, un método o un valor de enumeración
Cambiar el tipo de un campo
Cambiar un formato de nombre de recurso
Cambiar el formato de URL en la definición HTTP
Cambiar los formatos de salida, por ejemplo, cambiar 0 a -- como valor predeterminado
Cambiar el motivo del error que se muestra de A a B
Versiones secundarias
Las versiones secundarias solo introducen cambios retrocompatibles.
Cuando se lanza una versión secundaria, el extremo que ya está en uso se actualiza de forma automática. Esto no hará que se rompa el código. Puedes seguir usando tu biblioteca cliente existente.
Las versiones secundarias incluyen funciones nuevas o actualizaciones que no afectan el código existente. Si deseas usar las funciones nuevas, debes actualizar tu
biblioteca cliente a la versión
más reciente.
Puestas de sol
Cuando se programe la baja de una versión anterior de la API de Search Ads 360 Reporting, publicaremos un aviso en el grupo de Google searchads-api-announcements.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eThe Search Ads 360 Reporting API uses semantic versioning with major and minor versions, where major versions introduce breaking changes and minor versions are backwards-compatible.\u003c/p\u003e\n"],["\u003cp\u003eMajor version releases require code changes and utilize separate endpoints, while minor version releases automatically update the existing endpoint without breaking existing code.\u003c/p\u003e\n"],["\u003cp\u003eBreaking changes in major versions might involve removing or renaming elements, changing types or formats, or modifying outputs and error reasons.\u003c/p\u003e\n"],["\u003cp\u003eMinor versions bring new features or updates but do not affect existing code; to utilize new features, upgrade your client library.\u003c/p\u003e\n"],["\u003cp\u003eSunset notices for older API versions are posted on the searchads-api-announcements Google group.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API uses semantic versioning with major (e.g., v0) and minor (e.g., v0_1) versions. Major versions have breaking changes, require code modifications, a new endpoint, and client library upgrades. Minor versions are backward-compatible, automatically update the existing endpoint, and only require client library upgrades for new features. Breaking changes may involve removing or renaming elements, changing field types or output formats. Sunsets are posted on the Google group.\n"],null,["# Versioning in the Search Ads 360 Reporting API\n\nThe Search Ads 360 Reporting API uses [semantic versioning](https://semver.org/).\n\nThere are major and minor versions, formatted as\n`v`\u003cvar translate=\"no\"\u003eMAJOR\u003c/var\u003e`_`\u003cvar translate=\"no\"\u003eMINOR\u003c/var\u003e. For example, `v0_0` is the\nfirst major version, and `v0_1` the first minor version. The suffix of the\nversion number indicates the version type: for major versions it is always zero,\nand for minor versions it is always greater than zero.\n\nMajor versions\n--------------\n\nMajor releases introduce breaking changes, that is, changes that are not\nbackwards compatible.\n\nEach major version has a separate endpoint, for example: \n\n```text\nhttps://searchads360.googleapis.com/v0\n\nhttps://searchads360.googleapis.com/v1\n```\n\nWhen upgrading from one major version to another, you may need to change your\ncode before switching to the new major version endpoint.\n\nIf you use a [client library](/search-ads/reporting/client-libraries/client-libraries),\nyou need to upgrade to the newest version. New major versions provide a\nmigration guide to help you fix any breaking changes in your code.\n\nExamples of breaking changes include:\n\n- Removing or renaming a service, interface, field, method or enum value.\n- Changing the type of a field.\n- Changing a resource name format.\n- Changing the URL format in the HTTP definition.\n- Changing output formats, such as, changing `0` to `--` as the default value.\n- Changing the error reason returned from A to B.\n\nMinor versions\n--------------\n\nMinor versions introduce only backwards-compatible changes.\n\nWhen a minor version is released, the endpoint that is already in use is\nautomatically updated. This does not cause your code to break. You can continue\nto use your existing client library.\n\nMinor versions include new features or updates that do not affect your existing\ncode. If you want to use the new features, you need to upgrade your\n[client library](/search-ads/reporting/client-libraries/client-libraries) to the latest\nversion.\n\nSunsets\n-------\n\nWhen an older Search Ads 360 Reporting API version is scheduled to sunset, we\npost a notice on the [searchads-api-announcements](https://groups.google.com/g/searchads-api-announcements) Google group."]]
