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

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