L'identificatore univoco per un'entità nell'API Google Ads è chiamato nome risorsa ed è rappresentato come una stringa con un formato prevedibile. Se conosci gli ID dei componenti di un'entità, puoi utilizzare le utilità della libreria client Java per generare o analizzare il nome completo della risorsa.
Costruisci nomi delle risorse con ResourceNames
La classe di utilità ResourceNames crea il nome della risorsa di un'entità
quando conosci tutti gli ID pertinenti correlati a quell'entità. Ad esempio, il nome di una risorsa campagna ha il seguente formato:
customers/{customer_id}/campaigns/{campaign_id}
Se conosci l'ID cliente (senza trattini) e l'ID campagna, utilizza la classe
ResourceNames per creare il nome completo della risorsa nel seguente modo:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Puoi creare nomi delle risorse anche per altri tipi di entità, che accettano diversi parametri ID a seconda della forma finale del nome della risorsa.
Analizza i nomi delle risorse
Sebbene ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) sia
indipendente dalla versione in tutte le versioni dell'API supportate, la libreria client Java fornisce anche
classi di nomi di risorse fortemente tipizzate (come CampaignName,
AdGroupName e CustomerName) in ogni pacchetto di risorse con controllo delle versioni (ad esempio com.google.ads.googleads.v25.resources) che
consentono di analizzare una stringa del nome della risorsa nei suoi ID costituenti:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();