בדף הזה אנחנו מניחים שאתם מכירים את המדריכים למפתחים בנושא Resource Oriented Design וResource Names, ומוסיפים להם פרטים ספציפיים על ההטמעה של Google Ads API.
עיצוב מבוסס-משאבים
באופן כללי, Google Ads API מבוסס על תכנון ממוקד משאבים, שמורכב מאוספים של משאבים שאפשר לפנות אליהם בנפרד (שמות העצם של ה-API). הפניה למשאבים מתבצעת באמצעות שמות המשאבים, והמניפולציה שלהם מתבצעת באמצעות קבוצה קטנה של שיטות (שנקראות גם פעולות).
שמות המשאבים והשיטות האלה, בשילוב עם קידומת ספציפית של גרסת ה-API, מרכיבים את כתובות ה-URL של ממשק ה-REST. לדוגמה, אפשר לפרק את כתובת ה-URL שלמטה לרכיבים נפרדים לפי הטבלה הבאה:
https://googleads.googleapis.com/v21/customers/1234567890:mutate
| קידומת של גרסת ה-API | שם המשאב (יחסי) | שיטה |
|---|---|---|
https://googleads.googleapis.com/v21
|
customers/1234567890
|
mutate
|
כל כתובות ה-URL של REST לגרסה מסוימת של ה-API (למשל, v21)
יש להם קידומת משותפת של גרסת ה-API. שם המשאב והשיטה ביחד מציינים לאיזה שירות API מתבצעת קריאה.
ב-Google Ads API נעשה שימוש נרחב בשיטות מותאמות אישית, בניגוד לרוב ממשקי REST API הרגילים שמשתמשים בשיטות REST רגילות כמו list, get, create, update ו-delete. דוגמאות לשיטות מותאמות אישית ב-Google Ads API כוללות את search, searchStream ו-mutate.
בדפים הבאים מפורטים שמות המשאבים, שיטות השירות ומוסכמות השמות ב-JSON של Google Ads API. הדוגמאות האלה ממחישות איך משתמשים בהם יחד כדי להגדיר נקודות קצה של ממשק REST.