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

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

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

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

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

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

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

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

תפעול

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

create

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

update

המערכת מעדכנת את המשאב כך שיתאים למאפיינים של update

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

remove

המשאב יוסר.

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

פעולות אצווה

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

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

שינוי תשובות

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

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

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

מעקב אחר שינויים

כדי לעקוב אחרי שינויים שבוצעו באובייקטים בחשבון Google Ads, או כדי לאחזר את המצב הנוכחי של אובייקטים, אפשר להשתמש במשאבים change_status ו-change_event.

• change_status מספק סיכום של המשאבים שהשתנו בפרק זמן נתון.
• ‫change_event מספק היסטוריה מפורטת של השינויים, כולל הערכים הישנים והחדשים של השדות ששונו.

כדי לשלוח שאילתות למשאבים האלה, משתמשים ב-method ‏GoogleAdsService.SearchStream או GoogleAdsService.Search. מידע נוסף על סטרימינג של דוחות באמצעות GoogleAdsService