GoogleAdsService
הוא האובייקט המאוחד
שירות אחזור ודיווח של Google Ads API. בשירות יש כמה שיטות:
- אחזור מאפיינים ספציפיים של אובייקטים.
- אחזור מדדי ביצועים של אובייקטים על סמך טווח תאריכים.
- סדר אובייקטים לפי המאפיינים שלהם.
- משתמשים בתנאים כדי לציין אילו אובייקטים רוצים להחזיר בתשובה.
- מגבילים את מספר האובייקטים שמוחזרים.
הפונקציה GoogleAdsService
יכולה להחזיר תוצאות
בשתי דרכים:
GoogleAdsService.SearchStream
מחזירה את כל השורות בתגובת סטרימינג אחת, קבוצות תוצאות גדולות (יותר מ-10,000 שורות). אולי זה מתאים יותר אם האפליקציה באצווה רוצה להוריד נתונים רבים כמו ככל האפשר.- הפרדה של
GoogleAdsService.Search
ועוד תגובות גדולות לדפים של תוצאות שאפשר לנהל. אפשר לבחור יותר מתאים אם האפליקציה האינטראקטיבית שלך מציגה דף של תוצאות בזמן האימון.
למידע נוסף על דפדוף לעומת סטרימינג.
שליחת בקשה
שיטת החיפוש דורשת
SearchGoogleAdsRequest
, שכולל
של המאפיינים הבאים:
customer_id
- שפת שאילתות ב-Google Ads
query
שמציינת את המשאב שעליו צריך לשלוח את השאילתה, את המאפיינים פלחים, מדדים לאחזר, והתנאים שבהם יש להשתמש כדי להגביל אילו אובייקטים מוחזרים - (
GoogleAdsService.Search
בלבד) א'page_size
כדי לציין כמה אובייקטים יוחזרו בתגובה יחידה כאשר באמצעות חלוקה לדפים. - (
GoogleAdsService.Search
בלבד) אופציונלי:page_token
, כדי לאחזר את קבוצת התוצאות הבאה בזמן השימוש חלוקה לדפים.
למידע נוסף על שפת השאילתות ב-Google Ads, ניתן לעיין בשפת השאילתות של Google Ads guide.
עיבוד תשובה
הפונקציה GoogleAdsService
מחזירה רשימה של
GoogleAdsRow
אובייקטים.
כל GoogleAdsRow
מייצג אובייקט שהוחזר על ידי שאילתה, ומורכב
של מאפיינים שאוכלסו על סמך השדות המבוקשים
סעיף SELECT
. המאפיינים שלא נכללים בתנאי SELECT
לא
יאוכלס באובייקטים GoogleAdsRow
בתגובה.
לדוגמה, למרות של-ad_group_criterion
יש מאפיין status
,
השדה status
במאפיין ad_group_criterion
של השורה לא מאוכלס
תשובה לשאילתה שבה התנאי SELECT
לא כולל
ad_group_criterion.status
באופן דומה, המאפיין campaign
של השורה
לא מאוכלס אם התנאי SELECT
לא כולל שדות
משאב campaign
.
לכל GoogleAdsRow
יכולים להיות מאפיינים ומדדים שונים משורה אחרת
באותה קבוצת תוצאות; כך שיש לראות את השורות כאובייקטים
בשורות הקבועות של הטבלה.
סוגי enum לא ידועים
אין תמיכה מלאה במשאבים שמוחזרים בסוג של UNKNOWN
את גרסת ה-API הזו. ניתן ליצור את המשאבים האלה באמצעות
ממשקים כמו ממשק המשתמש של Google Ads. אפשר לבחור מדדים כשיש למשאב
מסוג UNKNOWN
, אבל אי אפשר לשנות את המשאב דרך ה-API.
דוגמה לכך היא קמפיין או מודעה חדשים שמוצגים בממשק המשתמש, אבל
לא נתמכת בגרסת ה-API שהשאילתה נשלחה עליה.
הנה כמה שיקולים שכדאי לזכור:
- אפשר לתמוך במשאב מסוג
UNKNOWN
מאוחר יותר, או להישאר עם הכתובתUNKNOWN
ללא הגבלת זמן. - אובייקטים חדשים מסוג
UNKNOWN
יכולים להופיע בכל שלב. האובייקטים האלה בתאימות לאחור כי ערך ה-enum כבר זמין. מקורות מידע ליישם את השינוי הזה ברגע שהם זמינים, כדי שתהיה לך תצוגה מדויקת של החשבון שלך. המשאבUNKNOWN
יכול להופיע בגלל פעילויות חדשות בחשבון שלכם דרך ממשקים אחרים, או כאשר משאב אינה נתמכת יותר. - אפשר לצרף אליהם
UNKNOWN
משאבים מדדים מפורטים שניתן להריץ עליו שאילתה. - בדרך כלל, המשאבים
UNKNOWN
מוצגים במלואם בממשק המשתמש של Google Ads. - בדרך כלל אי אפשר לשנות משאבים ב-
UNKNOWN
.
פילוח
התשובה תכיל ערך אחד מסוג GoogleAdsRow
לכל שילוב של הערכים
הבאים:
- מופע של המשאב הראשי שצוין בתנאי
FROM
- הערך של כל שדה
segment
שנבחר
לדוגמה, התשובה לשאילתה שבוחרת באפשרות FROM campaign
,
segments.ad_network_type
ו-segments.date
בסעיף SELECT
:
לכלול שורה אחת לכל שילוב של הפריטים הבאים:
campaign
segments.ad_network_type
segments.date
התוצאות מפולחות במרומז לפי כל מופע של המשאב הראשי, ולא לפי הערכים של השדות הספציפיים שנבחרו. לדוגמה,
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
תוצאות בשורה אחת לכל קמפיין, ולא בשורה אחת לכל ערך ייחודי של
שדה campaign.status
.