שיטות השירות

העיצוב של Google Ads API שונה מהארכיטקטורה המסורתית של REST, כי הוא מבוסס בעיקר על שיטות מותאמות אישית כמו search ו-mutate,, ולא על השיטות המסורתיות יותר: list, get, create, update ו-delete. הפעולות האלה מפורטות בכתובות URL של REST על ידי שימוש במוסכמה מיפוי HTTP של : כדי להפריד בין פועל פועל מותאם אישית לשאר כתובת ה-URL.

לדוגמה, קריאה ל-API של שינוי קמפיין משתמשת בכתובת ה-URL הבאה:

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

אחת הסיבות לכך שה-API משתמש בשיטות מותאמות אישית היא כדי להפעיל קבוצה של פעולות מרובות בבקשת API אחת. סמנטיקה מחמירה של REST תאפשר עדכון של קמפיין אחד בלבד. לדוגמה, ב-REST מסורתי update לקמפיין צריך לשלוח בקשת HTTP PATCH אחת לכל משאב של הקמפיין.

כדי לאפשר רישום של פעולות רבות בגוף הבקשה יחיד, Google Ads API מגדיר במקום זאת שיטת mutate מותאמת אישית לרוב המשאבים. באופן דומה, כדי להפעיל קריאות באצווה (מאחזרות אובייקטים רבים בו-זמנית) מה-API, נעשה שימוש ב-API בשיטת search מותאמת אישית עם שפת שאילתה ב-Google Ads, שדומה ל-SQL.

בדף methods נפוצים מפורטות השיטות הנפוצות ביותר ב-Google Ads API.