Названия ресурсов

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

Класс ResourceNames

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

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

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

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