Nomes de recursos

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 de recurso 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 de cliente e o ID da campanha, use o utilitário ResourceNames para criar o nome completo do recurso da seguinte maneira:

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
  );

O utilitário ResourceNames fornece métodos auxiliares semelhantes para outros tipos de entidade, como ad_group(), customer() e ad_group_criterion(). Observe que ResourceNames tem como escopo cada namespace de versão de API compatível (como V26, em que as versões secundárias da API, como v25.1, usam o módulo de versão principal V25). Portanto, substitua V26 pela versão de API de destino se estiver usando uma versão anterior. Consulte o arquivo de origem ResourceNames.pm para ver a lista completa de métodos auxiliares compatíveis.