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

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

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

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

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

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

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

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

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

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

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

תפעול

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

create

יצירת מכונה חדשה של המשאב

update

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

remove

הסרת המשאב.

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

קיבוץ פעולות

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

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

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

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

שגיאות ב-Mutate

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