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