यह पेज संसाधनों के लिए की गई डिज़ाइन और संसाधन नाम डेवलपर गाइड और उन्हें Google Ads API को लागू करने की खास जानकारी दे.
संसाधनों के हिसाब से डिज़ाइन
आम तौर पर, Google Ads API संसाधनों को ध्यान में रखकर डिज़ाइन किया जाता है. इसका मॉडल अलग-अलग पते पर मिल सकने वाले संसाधनों का कलेक्शन (एपीआई की संज्ञा). संसाधनों को उनके संसाधन नामों के साथ रेफ़र किया जाता है और उनमें बदलाव करने के लिए तरीका का सेट (इसे वर्ब या ऑपरेशन भी कहा जाता है).
इन संसाधनों के नाम और तरीके, एक साथ दिखते हैं खास एपीआई वर्शन प्रीफ़िक्स के साथ, REST इंटरफ़ेस के यूआरएल बनाएं. उदाहरण के लिए, यहां दिए गए यूआरएल को अलग-अलग कॉम्पोनेंट में बांटा जा सकता है नीचे दी गई टेबल के मुताबिक:
https://googleads.googleapis.com/v17/customers/1234567890:mutate
| एपीआई वर्शन प्रीफ़िक्स | संसाधन का नाम (मिलता-जुलता) | तरीका |
|---|---|---|
https://googleads.googleapis.com/v17
|
customers/1234567890
|
mutate
|
एपीआई के किसी खास वर्शन के लिए सभी REST यूआरएल (जैसे, v17)
एक सामान्य एपीआई वर्शन प्रीफ़िक्स शेयर करें. संसाधन का नाम और तरीका, एक साथ
यह पहचान करता है कि किस एपीआई सेवा को कॉल किया जा रहा है.
Google Ads API, ज़्यादातर ग्राहकों के मुकाबले पसंद के मुताबिक तरीकों का ज़्यादा इस्तेमाल करता है
ट्रेडिशनल REST API, जो REST के स्टैंडर्ड तरीकों का इस्तेमाल करता है. जैसे, list, get,
create, update, और delete. Google Ads API में पसंद के मुताबिक बनाए गए तरीकों के उदाहरण
search, searchStream, और mutate शामिल हैं.
यहां दिए गए पेजों पर, Google Ads API के संसाधनों के बारे में ज़्यादा जानकारी दी गई है name, सेवा के तरीके, और JSON का नाम रखने के तरीके, ताकि यह दिखाया जा सके कि इनका इस्तेमाल कैसे किया जाता है REST इंटरफ़ेस एंडपॉइंट तय करने के लिए एक साथ इस्तेमाल किए जाते हैं.