संसाधन के नाम

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

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

संसाधन संसाधन नाम
ग्राहक customers/1234567890
कैंपेन customers/1234567890/campaigns/8765432109
विज्ञापन समूह 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) का रेफ़रंस देने के लिए, नए संसाधन के नाम मिल सकते हैं.