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

Уникальный идентификатор объекта в 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, такие как v26.1, используют модуль основной версии V26). Поэтому, если вы используете более раннюю версию, замените V26 на целевую версию API. Полный список поддерживаемых вспомогательных методов приведен в исходном файле ResourceNames.pm.