संसाधन के नाम

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.v26.resources) में स्ट्रॉन्गली-टाइप्ड रिसॉर्स नेम क्लास (जैसे, CampaignName, AdGroupName, और CustomerName) भी उपलब्ध कराती है. इनकी मदद से, रिसॉर्स नेम स्ट्रिंग को उसके कॉम्पोनेंट आईडी में वापस पार्स किया जा सकता है:

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

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