Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcenname bezeichnet und als String mit einem vorhersagbaren Format dargestellt. Wenn Sie die Bestandteils-IDs einer Entität kennen, können Sie mit den Dienstprogrammen der Java-Clientbibliothek den vollständigen Ressourcennamen generieren oder parsen.
Ressourcennamen mit ResourceNames erstellen
Mit der Hilfsklasse ResourceNames wird der Ressourcenname einer Entität erstellt, 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 Kunden-ID (ohne Bindestriche) und die Kampagnen-ID kennen, verwenden Sie die Klasse ResourceNames, um den vollständigen Ressourcennamen so zu 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 für alle unterstützten API-Versionen versionsunabhängig. 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.v25.resources), mit denen Sie einen Ressourcennamenstring in seine Bestandteils-IDs parsen können:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();