Unikalny identyfikator jednostki w interfejsie Google Ads API to nazwa zasobu. Jest on reprezentowany jako ciąg znaków o przewidywalnym formacie. Jeśli znasz identyfikatory składowe jednostki, możesz użyć narzędzi biblioteki klienta Java, aby wygenerować lub przeanalizować pełną nazwę zasobu.
Tworzenie nazw zasobów za pomocą klasy ResourceNames
Klasa narzędziowa ResourceNames tworzy nazwę zasobu encji, gdy znasz wszystkie odpowiednie identyfikatory powiązane z tą encją. Na przykład nazwa zasobu kampanii ma ten 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 obiektów, które akceptują różne parametry identyfikatora w zależności od ostatecznej formy nazwy zasobu.
Analizowanie nazw zasobów
Chociaż ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) jest niezależny od wersji we wszystkich obsługiwanych wersjach interfejsu API, biblioteka klienta Java udostępnia też w każdym pakiecie zasobów z określoną wersją (np. com.google.ads.googleads.v25.resources) klasy nazw zasobów o ściśle określonym typie (np. CampaignName, AdGroupName i CustomerName), które umożliwiają przekształcenie ciągu nazwy zasobu z powrotem w jego identyfikatory składowe:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();