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

המטרה: להבין איך לשנות ולבדוק אובייקטים באמצעות Google Ads API.

כפי שצוין במדריך למבנה ה-API, לכל משאב ברמה העליונה ב-Google Ads API יש שירות תואם ספציפי לסוג המשאב, שתומך ב:

• שינוי מופעים של המשאב
• אחזור של מופע יחיד של המשאב לצורך בדיקה

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

מונח מפתח: משאב ברמה העליונה הוא משאב ששמו לא כולל נקודה (.). לדוגמה, Campaign הוא משאב ברמה העליונה, אבל Campaign.NetworkSettings לא.

שינוי אובייקטים

לכל שירות ספציפי לסוג משאב תהיה שיטת mutate שמקבלת בקשת שינוי. הבקשה הזו כוללת:

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

לדוגמה, השיטה MutateCampaigns של CampaignService מקבלת MutateCampaignsRequest שכולל:

• א customerId
• אוסף של CampaignOperation אובייקטים
• השדה response_content_type שמציין את סוג התשובה המועדף.

פעולות

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

create

יוצר מופע חדש של המשאב.

update

המשאב יתעדכן בהתאם למאפיינים של המשאב update. כשמגדירים את השדה הזה, צריך גם להגדיר את השדה update_mask של הפעולה, שמציין ל-Google Ads API אילו מאפיינים צריך לשנות במהלך פעולת העדכון. לכל ספריית לקוח יש כלי עזר או שיטה שעוזרת ליצור בשבילכם את update_mask, כפי שמודגם בספריות הלקוח.

remove

הסרת המשאב.

מכיוון שהשדה operation הוא שדה oneof, אי אפשר להשתמש בפעולה אחת כדי לשנות מספר אובייקטים. לדוגמה, אם רוצים ליצור קמפיין אחד ולהסיר קמפיין אחר, צריך להוסיף שני מופעים של CampaignOperation לבקשה: אחד עם קבוצת create ומופע נוסף עם קבוצת remove.

פעולות אצווה

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

לדוגמה, אם רוצים ליצור עשרה קמפיינים, צריך לשלוח MutateCampaignsRequest יחיד שיש בו עשרה אובייקטים מסוג CampaignOperation.

שינוי התשובות

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

שגיאות שינוי

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

אזהרה: השירות get לא נתמך יותר. השתמשו ב-search או ב-searchStream כדי לאחזר במקום זאת אובייקטים.

בדיקת אובייקטים באמצעות get (הוצא משימוש)

בנוסף לשינוי האובייקטים, לכל שירות ספציפי לסוג משאב יש גם שיטת get לאחזור כל המאפיינים של משאב יחיד. השיטה הזו מקבלת בקשת get שהמאפיין היחיד שלה הוא resource_name.

נקודה חשובה: כדאי להשתמש ב-get בצורה מצומצמת.

שיטות get הן אפשרויות נוחות ש-Google Ads API מציע כדי להקל לאחזר את כל המאפיינים של אובייקט יחיד. זה כלי נהדר ללימוד של ה-API או לבדיקה של אובייקט מסוים למטרות ניפוי באגים או חינוך, אבל אסור להשתמש באפליקציה בשיטות אחזור כדי לאחזר אובייקטים לעיבוד או לדיווח. במקום זאת, כדאי להשתמש ב-GoogleAdsService, כי הוא מאפשר לאחזר רק מאפיינים ספציפיים של אובייקטים, תומך באחזור מדדי ביצועים ומאפשר סטרימינג דרך קבוצות גדולות של תוצאות. אם האפליקציה שלכם שולחת מספר גדול של בקשות, יכול להיות שיחולו הגבלות קצב של יצירת בקשות.