Nombres de recursos

El identificador único de una entidad en la API de Google Ads se denomina nombre de recurso y se representa como una cadena con un formato predecible. Si conoces los componentes de un nombre de recurso, puedes usar la utilidad ResourceNames para generar el nombre del recurso con formato.

Clase ResourceNames

La utilidad ResourceNames construye el nombre del recurso de una entidad cuando conoces todos los IDs relevantes relacionados con esa entidad. Pasa los IDs como cadenas que solo contengan dígitos, sin guiones.

Por ejemplo, el nombre de un recurso de campaña tiene el formato customers/{customer_id}/campaigns/{campaign_id}. Si conoces el ID de cliente y el ID de campaña, puedes usar la utilidad ResourceNames para construir el nombre completo del recurso de la siguiente manera:

use Google::Ads::GoogleAds::V26::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V26::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

La utilidad ResourceNames proporciona métodos auxiliares similares para otros tipos de entidades, como ad_group(), customer() y ad_group_criterion(). Ten en cuenta que ResourceNames tiene un alcance para cada espacio de nombres de versión de la API compatible (como V26, en el que las versiones secundarias de la API, como v25.1, usan su módulo de versión principal V25), por lo que debes reemplazar V26 por tu versión de la API de destino si usas una versión anterior. Consulta el archivo de origen ResourceNames.pm para obtener la lista completa de métodos auxiliares compatibles.