Имена ресурсов

Уникальный идентификатор сущности в API Google Ads называется именем ресурса и представляется в виде строки с предсказуемым форматом. Если вам известны составляющие части имени ресурса, вы можете использовать утилиту ResourceNames для генерации отформатированного имени ресурса.

Класс ResourceNames

Утилита ResourceNames формирует имя ресурса сущности, если известны все соответствующие идентификаторы, относящиеся к этой сущности. Передавайте идентификаторы в виде строк, содержащих только цифры, без дефисов.

Например, имя ресурса кампании имеет формат customers/{customer_id}/campaigns/{campaign_id} . Если вам известны идентификатор клиента и идентификатор кампании, вы можете использовать утилиту ResourceNames для построения полного имени ресурса следующим образом:

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

Утилита ResourceNames предоставляет аналогичные вспомогательные методы для других типов сущностей, таких как ad_group() , customer() и ad_group_criterion() . Обратите внимание, что ResourceNames ограничена пространством имен каждой поддерживаемой версии API (например, V25 , где минорные версии API, такие как v25.1 , используют свой основной модуль версии V25 ), поэтому замените V25 на целевую версию API, если используете более раннюю версию. Полный список поддерживаемых вспомогательных методов см. в исходном файле ResourceNames.pm .