Unikalny identyfikator elementu w interfejsie Google Ads API nazywa się nazwą zasobu i jest reprezentowany jako ciąg znaków o przewidywalnym formacie. Jeśli znasz elementy składowe nazwy zasobu, możesz użyć narzędzia ResourceNames, aby wygenerować sformatowaną nazwę zasobu.
Klasa ResourceNames
Narzędzie ResourceNames tworzy nazwę zasobu encji, gdy znasz wszystkie powiązane z nią identyfikatory. Przekaż identyfikatory jako ciągi znaków zawierające tylko cyfry, bez łączników.
Na przykład nazwa zasobu kampanii ma format customers/{customer_id}/campaigns/{campaign_id}. Jeśli znasz identyfikator klienta i identyfikator kampanii, możesz użyć narzędzia ResourceNames, aby utworzyć pełną nazwę zasobu w ten sposób:
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
);
Narzędzie ResourceNames udostępnia podobne metody pomocnicze dla innych typów elementów, takich jak ad_group(), customer() i ad_group_criterion(). Pamiętaj, że ResourceNames jest ograniczony do każdej obsługiwanej przestrzeni nazw wersji interfejsu API (np. V26, gdzie mniejsze wersje interfejsu API, takie jak v26.1, używają modułu wersji głównej V26), więc zastąp V26 docelową wersją interfejsu API, jeśli używasz wcześniejszej wersji. Pełną listę obsługiwanych metod pomocniczych znajdziesz w pliku źródłowym ResourceNames.pm.