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

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

שגיאות בשינוי

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