קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה נעזרים במדריכים למפתחים בנושא עיצוב שמתמקד במשאבים ושמות משאבים, ומוסיפים להם פרטי הטמעה ספציפיים של Search Ads 360 Reporting API.
עיצוב ממוקד משאבים
באופן כללי, Search Ads 360 Reporting API מבוסס על תכנון שמתמקד במשאבים, ומתבסס על אוספים של משאבים שניתן לגשת אליהם בנפרד (השמות העצם של ה-API).
ההפניות למשאבים מתבצעות באמצעות שמות המשאבים, והפעולות עליהם מתבצעות באמצעות קבוצה קטנה של שיטות (שנקראות גם פעלים או פעולות).
שמות המשאבים וה-methods האלה, בשילוב עם קידומת ספציפית של גרסת API, מהווים את כתובות ה-URL של ממשק ה-REST.
לדוגמה, אפשר לפרק את כתובת ה-URL הבאה לרכיבים הנפרדים האלה לפי הטבלה הבאה:
כל כתובות ה-URL ל-REST של גרסת API מסוימת (למשל, v0) יש להם קידומת משותפת של גרסת API. השם והשיטה של המשאב מזהים יחד לאיזה שירות API מתבצעת הקריאה.
ב-Search Ads 360 Reporting API נעשה שימוש נרחב בשיטות בהתאמה אישית, בניגוד לרוב ממשקי ה-API הרגילים מסוג REST שמשתמשים בשיטות רגילות של REST כמו list ו-get. Search Ads 360 Reporting API כולל שתי שיטות בהתאמה אישית: search ו-searchStream.
בדפים הבאים מוסבר בפירוט על שמות המשאבים, שיטות השירות וכללי השמות של JSON ב-Search Ads 360 Reporting API, כדי להמחיש איך משתמשים בהם יחד כדי להגדיר נקודות קצה של ממשק REST.
[[["התוכן קל להבנה","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-08-29 (שעון UTC)."],[],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]
