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 avec un format prévisible. Si vous connaissez les ID 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.
Construire des noms de ressources avec ResourceNames
La classe 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 l'ID client (sans tirets) et l'ID de campagne, utilisez la classe ResourceNames pour construire le nom de ressource complet 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 ressource.
Analyser les noms de ressources
Alors que ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) est 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 versionné (par exemple, com.google.ads.googleads.v25.resources) qui vous permettent d'analyser une chaîne de nom de ressource pour en extraire les ID constitutifs :
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();