सेवा के तरीके

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

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

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

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

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

सामान्य तरीके वाला पेज सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके से जुड़ा है.