ID
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La mayoría de las entidades de Google Ads exponen un método getId() que devuelve su identificador. Si bien no son estrictamente necesarios en la mayoría de los casos, los IDs pueden ser útiles en las siguientes situaciones:
- Trabaja con informes
- Los IDs son una buena forma de vincular una fila del informe con la entidad real de Google Ads.
- Cómo mantener una asignación con un almacén de datos externo
- Es posible que ya tengas información basada en IDs almacenada en tu propia base de datos.
- Buscas un poco más de rendimiento
La recuperación por IDs suele ser más rápida que otras alternativas. El código para recuperar una sola entidad también es un poco más sencillo:
let campaigns = AdsApp.campaigns()
.withIds([678678])
.get();
// vs.
let campaigns = AdsApp.campaigns()
.withCondition("Name='My Campaign'")
.get();
Unicidad
Los IDs de campaña y de grupo de anuncios son únicos: ninguna campaña ni grupo de anuncios compartirán el mismo ID. Sin embargo, los anuncios y las palabras clave tienen IDs compuestos: el identificador único de una palabra clave es una combinación de su ID de grupo de anuncios y su ID de palabra clave.
Del mismo modo, un identificador único de un anuncio es una combinación de su ID de grupo de anuncios y su ID de anuncio. Esto tiene implicaciones en la forma en que se llama a selector.withIds().
En el caso de las campañas y los grupos de anuncios, selector.withIds() espera un array de números:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Sin embargo, para los anuncios y las palabras clave, selector.withIds() necesita un array de arrays de dos elementos, en el que el primer elemento es el ID del grupo de anuncios. El siguiente fragmento recupera tres palabras clave de un grupo de anuncios:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
La misma construcción se aplica cuando se recuperan anuncios.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-27 (UTC)
[null,null,["Última actualización: 2025-08-27 (UTC)"],[[["\u003cp\u003eMost Google Ads entities have a \u003ccode\u003egetId()\u003c/code\u003e method, which returns a unique identifier that can be useful for linking data, improving performance, and referencing external databases.\u003c/p\u003e\n"],["\u003cp\u003eWhen working with reports, IDs can connect report rows to specific Google Ads entities.\u003c/p\u003e\n"],["\u003cp\u003eFetching entities by ID is often faster than using other methods like filtering by name.\u003c/p\u003e\n"],["\u003cp\u003eCampaign and ad group IDs are unique, while ad and keyword IDs are composite, requiring both the ad group ID and their individual ID for unique identification.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eselector.withIds()\u003c/code\u003e method is used to fetch entities by ID, taking an array of numbers for campaigns and ad groups and an array of two-element arrays (ad group ID and entity ID) for ads and keywords.\u003c/p\u003e\n"]]],[],null,["# IDs\n\nMost Google Ads entities expose a `getId()` method that returns their\nidentifier. While not strictly necessary in most cases, IDs may come in handy\nwhen\n\nWorking with [reports](/google-ads/scripts/docs/features/reports)\n: IDs provide a good way to link a report row to the actual Google Ads entity.\n\nMaintaining a mapping with an external data store\n: You may already have ID-based information stored in your own database.\n\nLooking for a bit of a performance boost\n\n: Fetching by IDs is often quicker than alternatives. The code for fetching a\n single entity is a bit easier too:\n\n let campaigns = AdsApp.campaigns()\n .withIds([678678])\n .get();\n // vs.\n let campaigns = AdsApp.campaigns()\n .withCondition(\"Name='My Campaign'\")\n .get();\n\nUniqueness\n----------\n\nCampaign IDs and ad group IDs are unique: no two campaigns or ad groups will\never share the same ID. Ads and keywords, however, have composite IDs: a unique\nidentifier of a keyword is a combination of its ad group ID and keyword ID.\nLikewise, a unique identifier of an ad is a combination of its ad group ID and\nad ID. This has implications for the way `selector.withIds()` is called.\n\nFor campaigns and ad groups, `selector.withIds()` expects an array of numbers: \n\n let ids = [123123, 234234, 345345];\n let campaignSelector = AdsApp.campaigns().withIds(ids);\n\nFor ads and keywords, however, `selector.withIds()` needs an array of\ntwo-element arrays, the first element being the ad group ID. The following\nsnippet retrieves three keywords from an ad group: \n\n let adGroupId = 123123;\n let keywordSelector = AdsApp.keywords().withIds([\n [adGroupId, 234234],\n [adGroupId, 345345],\n [adGroupId, 456456]\n ]);\n\nThe same construct applies when fetching ads."]]
