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

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

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

הפקודה 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.