संसाधन के नाम

नाम की हैरारकी

Search Ads 360 Reporting API में इस्तेमाल किए गए संसाधन के नाम, हैरारकी के हिसाब से होते हैं. ये Search Ads 360 में मौजूद इकाइयों के संगठन को दिखाते हैं. लगभग सभी संसाधन, Customer संसाधन के सब-रिसॉर्स होते हैं. इससे यह पता चलता है कि एपीआई के लगभग हर कॉल को, Search Ads 360 के किसी खास खाते को टारगेट करना होता है. उदाहरण के लिए, कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड, ये सभी रूट कस्टमर रिसॉर्स के सब-रिसॉर्स होते हैं.

संसाधन संसाधन नाम
ग्राहक customers/1234567890
कैंपेन customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210
.

रिसॉर्स के आईडी

Search Ads 360 Reporting API की इकाइयों (ग्राहक, कैंपेन वगैरह) को, एपीआई में उनके संसाधन के नामों से रेफ़र किया जाता है. हालांकि, यह ध्यान रखना ज़रूरी है कि संसाधन के नामों में, यूनीक संख्या वाले संसाधन आईडी हो सकते हैं. इनसे हैरारकी में मौजूद हर ऑब्जेक्ट की पहचान की जा सकती है. ऐसे मामलों में, संसाधन के आईडी निकालने और नया आईडी बनाने के लिए, संसाधन के नाम को पार्स करना काम का हो सकता है.

उदाहरण के लिए, पिछली टेबल में दिए गए AdGroupAd संसाधन के नाम की जांच करें:

customers/1234567890/adGroupAds/54321098765~2109876543210

इसे अलग-अलग संसाधन के आईडी में तोड़ा जा सकता है. इन्हें कलेक्शन आईडीसे अलग किया जाता है. जैसे:

संसाधन के नाम के कॉम्पोनेंट
रिसॉर्स के आईडी
ग्राहक आईडी:
"1234567890"
विज्ञापन ग्रुप का आईडी:
"54321098765"
विज्ञापन ग्रुप के विज्ञापन आईडी:
"2109876543210"
कलेक्शन आईडी
"customers"
"adGroupAds"

अलग-अलग आईडी को पार्स करने से, संसाधन के नए नाम बनाए जा सकते हैं. इनका इस्तेमाल, विज्ञापन ग्रुप के विज्ञापन के ग्राहक (customers/1234567890) या उसके विज्ञापन ग्रुप (customers/1234567890/adGroupAds/54321098765) को रेफ़र करने के लिए किया जा सकता है.