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

‫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.