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 constitutivos de un nombre de recurso, puedes usar la utilidad ResourceNames para generar el nombre de recurso con el formato adecuado.

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 contengan solo 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 del cliente y el ID de la campaña, puedes usar la utilidad ResourceNames para construir el nombre completo del recurso de la siguiente manera:

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

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

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V25::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 se limita a cada espacio de nombres de versión de API compatible (como V25, 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 V25 por la versión de API de destino si usas una versión anterior. Consulta el archivo fuente de ResourceNames.pm para obtener la lista completa de métodos auxiliares admitidos.