מתבצע אחזור של אובייקטים

‫GoogleAdsService הוא שירות מאוחד לאחזור ולדיווח של אובייקטים ב-Google Ads API. לשירות יש methods ש:

  • אחזור מאפיינים ספציפיים של אובייקטים.
  • אחזור מדדי ביצועים של אובייקטים על סמך טווח תאריכים.
  • סידור אובייקטים על סמך המאפיינים שלהם.
  • משתמשים בתנאים כדי לציין אילו אובייקטים רוצים להחזיר בתשובה.
  • הגבלת מספר האובייקטים שמוחזרים.

הפונקציה GoogleAdsService יכולה להחזיר תוצאות בשתי דרכים:

  • ‫GoogleAdsService.SearchStream מחזירה את כל השורות בתגובה אחת של סטרימינג, מה שיעיל יותר עבור קבוצות גדולות של תוצאות (יותר מ-10,000 שורות). האפשרות הזו מתאימה יותר אם האפליקציה שלכם רוצה להוריד כמה שיותר נתונים כמה שיותר מהר.
  • ‫GoogleAdsService.Search מחלק תגובות גדולות לדפים קטנים יותר של תוצאות. האפשרות הזו מתאימה יותר אם האפליקציה האינטראקטיבית שלכם מציגה דף תוצאות בכל פעם.

מידע נוסף על הבדלים בין דפדוף לבין סטרימינג

שליחת בקשה

שיטת החיפוש דורשת SearchGoogleAdsRequest, שכוללת את המאפיינים הבאים:

  • customer_id
  • שאילתת query בשפת השאילתות של Google Ads שמציינת את המשאב שאליו מתבצעת השאילתה, המאפיינים, הפלחים והמדדים לאחזור, והתנאים לשימוש כדי להגביל את האובייקטים שמוחזרים
  • (GoogleAdsService.Search בלבד) פרמטר page_token אופציונלי לאחזור המקבץ הבא של תוצאות כשמשתמשים בחלוקה לדפים.

מידע נוסף על שפת השאילתות של Google Ads זמין במדריך שפת השאילתות של Google Ads.

עיבוד תשובה

הפונקציה GoogleAdsService מחזירה רשימה של אובייקטים מסוג GoogleAdsRow.

כל GoogleAdsRow מייצג אובייקט שמוחזר על ידי שאילתה, והוא מורכב מקבוצת מאפיינים שאוכלסים על סמך השדות שנדרשו בסעיף SELECT. מאפיינים שלא נכללים בסעיף SELECT לא מאוכלסים באובייקטים GoogleAdsRow בתשובה.

לדוגמה, למרות של-ad_group_criterion יש מאפיין status, השדה status של מאפיין ad_group_criterion בשורה לא מאוכלס בתגובה לשאילתה שבה סעיף SELECT לא כולל ad_group_criterion.status. באופן דומה, המאפיין campaign של השורה לא מאוכלס אם סעיף SELECT לא כולל שדות מהמשאב campaign.

לכל GoogleAdsRow יכולים להיות מאפיינים ומדדים שונים משורה אחרת באותה קבוצת תוצאות, ולכן צריך להתייחס לשורות כאובייקטים ולא כשורות קבועות בטבלה.

סוגי enum לא ידועים

ממשקי API בגרסה הזו לא תומכים באופן מלא במשאבים שמוחזרים עם סוג UNKNOWN. יכול להיות שהמשאבים האלה נוצרו דרך ממשקים אחרים, כמו ממשק המשתמש של 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.

הקודם
שינוי אובייקטים
הבא
מטא-נתונים של משאבים