שיטות השירות

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

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

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

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

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

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