Unikalny identyfikator jednostki w interfejsie Google Ads API nazywa się nazwą zasobu i jest reprezentowany jako ciąg znaków o przewidywalnym formacie. Jeśli znasz poszczególne komponenty 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 odpowiednie identyfikatory powiązane z tą encją. Przekazuj 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::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
);
Narzędzie ResourceNames udostępnia podobne metody pomocnicze w przypadku 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.
V25, gdzie mniejsze wersje interfejsu API, takie jak v25.1, używają modułu głównej wersji V25), więc jeśli używasz starszej wersji, zastąp V25 docelową wersją interfejsu API. Pełną listę obsługiwanych metod pomocniczych znajdziesz w ResourceNames.pmpliku źródłowym.