नाम की हैरारकी
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
इसे अलग-अलग रिसॉर्स आईडी में बांटा जा सकता है. ये आईडी, कलेक्शन आईडी से अलग किए जाते हैं. इसे इस तरह बांटा जा सकता है:
| संसाधन के नाम के कॉम्पोनेंट | |||||||
|---|---|---|---|---|---|---|---|
| रिसॉर्स आईडी |
|
||||||
| कलेक्शन आईडी |
|
||||||
अलग-अलग आईडी को पार्स करने से, आपको विज्ञापन ग्रुप विज्ञापन के ग्राहक (customers/1234567890) या उसके विज्ञापन ग्रुप (customers/1234567890/adGroupAds/54321098765) का रेफ़रंस देने के लिए, नए संसाधन के नाम मिल सकते हैं.