Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcenname bezeichnet und als String mit einem vorhersehbaren Format dargestellt. Wenn Sie die einzelnen IDs einer Entität kennen, können Sie die Dienstprogramme der Java-Clientbibliothek verwenden, um den vollständigen Ressourcennamen zu generieren oder zu parsen.
Ressourcennamen mit ResourceNames erstellen
Die Dienstprogrammklasse ResourceNames erstellt den Ressourcennamen einer Entität, wenn Sie alle relevanten IDs für diese Entität kennen. Der Ressourcenname einer Kampagne hat beispielsweise das folgende Format:
customers/{customer_id}/campaigns/{campaign_id}
Wenn Sie die Kundennummer (ohne Bindestriche) und die Kampagnen-ID kennen, können Sie mit der Klasse ResourceNames den vollständigen Ressourcennamen so erstellen:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Sie können auch Ressourcennamen für andere Entitätstypen erstellen, die je nach endgültiger Form des Ressourcennamens unterschiedliche ID-Parameter akzeptieren.
Ressourcennamen parsen
ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) ist zwar versionsunabhängig für alle unterstützten API-Versionen, die Java-Clientbibliothek bietet jedoch auch stark typisierte Ressourcennamenklassen (z. B. CampaignName, AdGroupName und CustomerName) in jedem versionierten Ressourcenpaket (z. B. com.google.ads.googleads.v26.resources), mit denen Sie einen Ressourcennamenstring wieder in seine einzelnen IDs parsen können:
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();