L'identifiant unique d'une entité dans l'API Google Ads est appelé nom de ressource. Il est représenté sous la forme d'une chaîne au format prévisible. Si vous connaissez les ID des éléments constitutifs d'une entité, vous pouvez utiliser les utilitaires de la bibliothèque cliente Java pour générer ou analyser le nom complet de la ressource.
Créer des noms de ressources avec ResourceNames
La classe d'utilitaire ResourceNames construit le nom de ressource d'une entité lorsque vous connaissez tous les ID pertinents associés à cette entité. Par exemple, le nom d'une ressource de campagne est au format suivant :
customers/{customer_id}/campaigns/{campaign_id}
Si vous connaissez le numéro client (sans tirets) et l'ID de la campagne, utilisez la classe ResourceNames pour créer le nom complet de la ressource comme suit :
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Vous pouvez également créer des noms de ressources pour d'autres types d'entités, qui acceptent différents paramètres d'ID en fonction de la forme finale du nom de la ressource.
Analyser les noms de ressources
Bien que ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) soit indépendant de la version pour toutes les versions d'API compatibles, la bibliothèque cliente Java fournit également des classes de noms de ressources fortement typées (telles que CampaignName, AdGroupName et CustomerName) dans chaque package de ressources avec version (par exemple, com.google.ads.googleads.v26.resources) qui vous permettent d'analyser une chaîne de nom de ressource dans ses ID constitutifs :
import com.google.ads.googleads.v26.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();