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