O identificador exclusivo de uma entidade na API Google Ads é chamado de nome de recurso e é representado como uma string com um formato previsível. Se você souber os componentes de um nome de recurso, use o utilitário ResourceNames para gerar o nome formatado.
Classe ResourceNames
O utilitário ResourceNames cria o nome do recurso de uma entidade quando você
conhece todos os IDs relevantes relacionados a ela. Transmita os IDs como strings
que contenham apenas dígitos, sem hifens.
Por exemplo, o nome de um recurso de campanha está no formato
customers/{customer_id}/campaigns/{campaign_id}. Se você souber o ID do cliente
e o ID da campanha, use a utilidade ResourceNames para criar o
nome completo do recurso da seguinte maneira:
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
);
O utilitário ResourceNames oferece métodos auxiliares semelhantes para outros tipos de
entidade, como ad_group(), customer() e ad_group_criterion(). Observe que
ResourceNames tem escopo para cada namespace de versão da API compatível (como
V25, em que lançamentos secundários da API, como v25.1, usam o módulo
da versão principal V25). Portanto, substitua V25 pela versão
da API de destino se estiver usando uma versão anterior. Consulte o arquivo de origem ResourceNames.pm para conferir a lista completa de métodos auxiliares compatíveis.