Unikalny identyfikator elementu w interfejsie Google Ads API nosi nazwę nazwy zasobu i jest reprezentowany jako ciąg znaków o przewidywalnym formacie. Jeśli znasz identyfikatory złożone encji, możesz użyć narzędzi biblioteki klienta Java, aby wygenerować lub przeanalizować pełną nazwę zasobu.
Tworzenie nazw zasobów za pomocą ResourceNames
Klasa użytkowa ResourceNames tworzy nazwę zasobu encji, gdy znasz wszystkie powiązane z nią identyfikatory. Na przykład nazwa zasobu kampanii ma taki format:
customers/{customer_id}/campaigns/{campaign_id}
Jeśli znasz identyfikator klienta (bez łączników) i identyfikator kampanii, użyj klasy ResourceNames, aby utworzyć pełną nazwę zasobu w ten sposób:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Możesz też tworzyć nazwy zasobów dla innych typów elementów, które akceptują różne parametry identyfikatora w zależności od ostatecznej formy nazwy zasobu.
Analizowanie nazw zasobów
Klasa ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) jest niezależna od wersji we wszystkich obsługiwanych wersjach interfejsu API, ale biblioteka klienta Java udostępnia też silnie typowane klasy nazw zasobów (takie jak CampaignName, AdGroupName i CustomerName) w każdym pakiecie zasobów z wersją (np. com.google.ads.googleads.v26.resources), które umożliwiają analizowanie ciągu znaków nazwy zasobu z powrotem na jego identyfikatory złożone:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();