संसाधन के नाम

Google Ads API में किसी इकाई के यूनीक आइडेंटिफ़ायर को संसाधन का नाम कहा जाता है. इसे अनुमानित फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाया जाता है. अगर आपको किसी इकाई के कॉम्पोनेंट आईडी पता हैं, तो Java क्लाइंट लाइब्रेरी की सुविधाओं का इस्तेमाल करके, पूरे संसाधन का नाम जनरेट या पार्स किया जा सकता है.

ResourceNames की मदद से संसाधन के नाम बनाना

ResourceNames यूटिलिटी क्लास, किसी इकाई का संसाधन नाम बनाती है. ऐसा तब होता है, जब आपको उस इकाई से जुड़े सभी आईडी पता हों. उदाहरण के लिए, कैंपेन के संसाधन का नाम इस फ़ॉर्मैट में होता है:

customers/{customer_id}/campaigns/{campaign_id}

अगर आपको ग्राहक आईडी (बिना हाइफ़न वाला) और कैंपेन आईडी पता है, तो ResourceNames क्लास का इस्तेमाल करके पूरा संसाधन नाम इस तरह बनाएं:

long customerId = 1234567890L;
long campaignId = 9876543210L;

String campaignResourceName = ResourceNames.campaign(customerId, campaignId);

अन्य इकाई टाइप के लिए भी रिसॉर्स के नाम बनाए जा सकते हैं. ये रिसॉर्स के नाम, रिसॉर्स के नाम के फ़ाइनल फ़ॉर्म के आधार पर अलग-अलग आईडी पैरामीटर स्वीकार करते हैं.

संसाधन के नामों को पार्स करना

ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames), एपीआई के सभी वर्शन के साथ काम करता है. वहीं, Java क्लाइंट लाइब्रेरी, वर्शन वाले हर रिसॉर्स पैकेज (उदाहरण के लिए, com.google.ads.googleads.v25.resources) में, टाइप किए गए रिसॉर्स के नाम वाली क्लास (जैसे कि CampaignName, AdGroupName, और CustomerName) भी उपलब्ध कराती है. इनकी मदद से, रिसॉर्स के नाम वाली स्ट्रिंग को वापस उसके आईडी में पार्स किया जा सकता है:

import com.google.ads.googleads.v25.resources.CampaignName;

CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();