सेवा के तरीके

Google Ads API का डिज़ाइन, पुराने REST आर्किटेक्चर से अलग है, क्योंकि इसमें आम तौर पर list, get, create, update और delete जैसे पारंपरिक तरीकों के बजाय search और mutate, जैसे कस्टम तरीकों का इस्तेमाल किया जाता है. इन कार्रवाइयों को REST यूआरएल में : के एचटीटीपी मैपिंग कन्वेंशन का इस्तेमाल करके दिखाया जाता है. इससे, कस्टम वर्ब को बाकी यूआरएल से अलग करने में मदद मिलती है.

उदाहरण के लिए, एक कैंपेन म्यूटेट एपीआई कॉल इस यूआरएल का इस्तेमाल करता है:

https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate

एपीआई की ओर से कस्टम तरीकों का इस्तेमाल करने की एक वजह यह है कि एक से ज़्यादा कार्रवाइयों के बैच को एक ही एपीआई अनुरोध में चालू किया जा सकता है. सख्त REST सिमैंटिक सिर्फ़ एक बार में एक कैंपेन को ही अपडेट करने की अनुमति देते हैं. उदाहरण के लिए, किसी कैंपेन में परंपरागत REST update के लिए, हर कैंपेन रिसोर्स के लिए एक एचटीटीपी PATCH अनुरोध भेजना ज़रूरी होगा.

कई कार्रवाइयों को एक ही अनुरोध के मुख्य हिस्से में बंडल करने की अनुमति देने के लिए, Google Ads API ज़्यादातर संसाधनों के लिए कस्टम mutate तरीका तय करता है. इसी तरह, एपीआई में बैच रीड (एक साथ कई ऑब्जेक्ट फ़ेच करने) के लिए, एपीआई, SQL जैसे कस्टम searchमैथड का इस्तेमाल करता है Google Ads क्वेरी भाषा.

सामान्य तरीके वाले पेज पर, Google Ads API में सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीकों के बारे में बताया गया है.