קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
העיצוב של Google Ads API שונה מארכיטקטורת REST מסורתית, כי הוא משתמש בעיקר בשיטות בהתאמה אישית, כמו search ו-mutate,, במקום בשיטות המסורתיות יותר list, get, create, update ו-delete.
הפעולות האלה מופיעות בכתובות URL של REST באמצעות מיפוי HTTP של : כדי להפריד את הפועל המותאם אישית משאר כתובת ה-URL.
לדוגמה, קריאה ל-API לשינוי קמפיין משתמשת בכתובת ה-URL הבאה:
אחת מהסיבות לשימוש ב-methods בהתאמה אישית ב-API היא לאפשר קיבוץ של מספר פעולות לבקשת API אחת. סמנטיקה מחמירה של REST תאפשר לעדכן רק קמפיין אחד בכל פעם. לדוגמה, כדי לבצע בקשת REST רגילה update לקמפיין, צריך לשלוח בקשת HTTP PATCH אחת לכל משאב בקמפיין.
כדי לאפשר לאגד יחד פעולות רבות בגוף בקשה אחד, ב-Google Ads API מוגדר במקום זאת שיטה מותאמת אישית של mutate לרוב המשאבים.
באופן דומה, כדי לאפשר קריאות בכמות גדולה (אחזור של אובייקטים רבים בו-זמנית) מה-API, ה-API משתמש בשיטה מותאמת אישית של search עם שפת שאילתות של Google Ads שדומה ל-SQL.
בדף שיטות נפוצות מפורטות השיטות הנפוצות ביותר ב-Google Ads API.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-02-28 (שעון UTC)."],[[["The Google Ads API utilizes custom methods like `search` and `mutate` instead of standard REST methods for efficiency and batch operations."],["This approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST."],["Custom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, `https://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate`."],["Batching operations, like updating many campaigns simultaneously, are enabled through the custom `mutate` method, improving efficiency over individual requests."],["The `search` method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call."]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
